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 payout readiness.

Example response

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

Changes

Changed in 1 of the 74 revisions of this API.4

    • ●

      added the new blocked_by_parent enum value to the //// response property for the response status

      response-property-enum-value-added

    • ●

      added the new denied enum value to the //// response property for the response status

      response-property-enum-value-added

    • ●

      added the new manual_review enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new manual_review enum value to the //// response property for the response status

      response-property-enum-value-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.