Audience: the OWNER of the authenticated team (the team the token authorizes — with OAuth this can be a customer's team, not your own). Returns a Talentir URL where the team owner sets or edits the daily spending allowance for automatic payouts. The screen requires the visitor to sign in and be the team owner; the sign-in code is pre-sent to the session creator's email.
/session/allowanceAudience: the OWNER of the authenticated team (the team the token authorizes — with OAuth this can be a customer's team, not your own). Returns a Talentir URL where the team owner sets or edits the daily spending allowance for automatic payouts. The screen requires the visitor to sign in and be the team owner; the sign-in code is pre-sent to the session creator's email.
Team API key generated from team settings. Sent as Authorization: Bearer <api_key>.
In: header
application/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
curl -X POST "https://example.com/session/allowance" \ -H "Content-Type: application/json" \ -d '{ "redirectUrl": "http://example.com" }'{ "url": "http://example.com"}Kyb POST
Audience: a MEMBER OF THE AUTHENTICATED TEAM (the team the token authorizes — with OAuth this can be a customer's team, not your own). Validate the authenticated team and return a Talentir URL where a team member completes KYB (Know Your Business) verification. The screen requires the visitor to sign in and be a member of that team; the sign-in code is pre-sent to the session creator's email.
Get GET
Retrieve information for the authenticated team: name, KYB status, total converted wallet balance, balances, bank deposit instructions per currency, and the team's members with their roles (owners first). The per-balance 'depositInfo' field is deprecated in favor of the top-level 'deposits' array and will be removed on 2026-09-23.
URL the user is returned to after completing or leaving the Talentir screen.
uriWhose branding the hosted session screen carries. talentir (default): Talentir branding on the main host. team: the authenticated team's white-label subdomain and logo — requires that team's white-label feature. platform: the subdomain and logo of the team operating the calling OAuth client — OAuth-authenticated calls only, requires the operating team's white-label feature. Sandbox and preview hosts keep their current origin and carry the verified brand in a signed token.
"talentir"Value in
Overrides who the one-time sign-in code is pre-sent to (default: the team owner's email). A hint only — the allowance screen still requires the team owner.
email