Get Payment Agent
Returns the full profile of a single payment agent, including agents not publicly listed in the directory. Use this when you already have an agent's id and need their full details. The response always includes a currencies array with the agent's commission rates and withdrawal limits for each supported currency, and a urls array with the agent's associated websites (null if the agent has none registered). Pass me as the id to return the authenticated client's own agent profile.
Endpoint
/payment-agents/v1/agents/{id}Base URL: https://api.derivws.com
Status Codes
Error Responses
{
"data": {},
"errors": [
{
"status": 400,
"code": "InvalidAgentID",
"detail": { "message": "Agent ID must be numeric or the literal string 'me'" }
}
],
"metadata": {
"endpoint": "/payment-agents/v1/agents/abc",
"method": "GET",
"timing": 6
}
}{
"data": {},
"errors": [
{
"status": 404,
"code": "AgentNotFound",
"detail": { "message": "No payment agent exists with the given id" }
}
],
"metadata": {
"endpoint": "/payment-agents/v1/agents/999999",
"method": "GET",
"timing": 12
}
}Authentication Required
Deriv-App-ID header to identify your application. OAuth2 Scope: paymentAbout Get Payment Agent
The GET /payment-agents/v1/agents/{id} endpoint: Returns the full profile of a single payment agent, including agents not publicly listed in the directory. Use this when you already have an agent's id and need their full details. The response always includes a currencies array with the agent's commission rates and withdrawal limits for each supported currency, and a urls array with the agent's associated websites (null if the agent has none registered). Pass me as the id to return the authenticated client's own agent profile.
Any other questions? Get in touch