Skip to main content
GET
/
v1
/
delegates
/
session
/
{sessionToken}
curl -X GET https://api.delegare.dev/v1/delegates/session/sess_123456789 \
  -H "X-Delegare-Merchant-Id: your_merchant_id" \
  -H "X-Delegare-Api-Key: your_api_key"

{
  "status": "completed",
  "delegateToken": "dtok_abc123xyz789"
}
Once a user completes the setup process on the setupUrl, you can retrieve the status of the session to get the resulting delegateToken. Alternatively, you can listen for the delegate.created webhook.

​
Headers

​
X-Delegare-Merchant-Id
string
required
Your merchant identifier.
​
X-Delegare-Api-Key
string
required
Your merchant API key.

​
Path Parameters

​
sessionToken
string
required
The token generated during Create Setup Session.

​
Response

​
status
string
The status of the session (pending, completed, failed).
​
delegateToken
string
The token your agent uses to authorize charges (only present if status is completed).
curl -X GET https://api.delegare.dev/v1/delegates/session/sess_123456789 \
  -H "X-Delegare-Merchant-Id: your_merchant_id" \
  -H "X-Delegare-Api-Key: your_api_key"

{
  "status": "completed",
  "delegateToken": "dtok_abc123xyz789"
}