v8

OpenAPI 3.1.02026-08-033623795.0 MB
Payout accounts

Retrieve payout account

Retrieves the details of an existing payout account.

Required permissions:

  • payout:account:read
get/payout_accounts/{id}

Path parameters

idstring required
Example:poact_xxxxxxxxxxxx

The unique identifier of the payout account to retrieve.

Response

A successful response

business_namestring nullable required

The company's legal name

emailstring nullable required

The email address of the representative

idstring required

The unique identifier for the payout account.

phonestring nullable required

The business representative's phone

status'connected' | 'disabled' | 'action_required' | 'pending_verification' | 'verification_failed' | 'manual_review' | 'denied' | 'not_started' | 'blocked_by_parent' required

The granular calculated statuses reflecting payout account KYC and withdrawal readiness.

Example response

{
  "id": "poact_xxxxxxxxxxxx",
  "latest_verification": {
    "id": "verf_xxxxxxxxxxxxx",
    "last_error_reason": "Document image was too blurry to read."
  }
}