Get Payout Account

Get Payout Account

get

Path parameters

account_typestringRequired

account_idinteger · int32Required

Query parameters

extendedbooleanOptionalDefault: false

app_idinteger · int32Optional

App ID used to target the target payout account for merchant account types

Header parameters

X-Violet-TokenstringRequired

X-Violet-App-SecretstringRequired

X-Violet-App-Idinteger · int32Required

Responses

default

default response

application/json

Violet Payout Account that stores underlying payment provider account information to be used for disbursing funds during Order processing.

idinteger · int32Optional

Unique identifier for the object

account_typestring · enumOptional

Type of the account entity in Violet. This is either DEVELOPER or MERCHANT.

Possible values:

account_idinteger · int32Optional

Identifier of the account entity in Violet. This is either the Violet developer or merchant identifier.

merchant_idinteger · int32Optional

Identifier of the merchant entity in Violet.

app_idinteger · int32Optional

Identifier of the app entity in Violet that this Payout Account is associated with.

is_activebooleanOptional

Field that denotes whether or not this Payout Account is active and being used for transactions. Only one Payout Account may be active for a merchant-app combination at a given point in time.

country_codestringOptional

Two-letter country code of the bank that this Payout Account is associated to.

payment_providerstring · enumOptional

Payment Provider that the underlying payout account was created in. This is the provider that handles payment and payout processing for this entity.

Possible values:

payment_provider_account_idstringOptional

Identifier of the payout account in the payment provider system.

payment_provider_account_typestring · enumOptional

Type of account in the external payment provider. This field may not be present if the underlying payment provider does not have multiple account types.

Possible values:

payment_provider_accountobjectOptional

Details about the underlying payout account in the payment provider.

date_deactivatedstring · date-timeOptional

Time at which this payout account was deactivated. In ISO-8601 format.

date_createdstring · date-timeOptional

Time at which the object was created. In ISO-8601 format.

date_last_modifiedstring · date-timeOptional

Time at which the object was last modified. In ISO-8601 format.

get

/payments/{account_type}/{account_id}/payout_account

HTTPcURLJavaScriptPython

GET /v1/payments/{account_type}/{account_id}/payout_account HTTP/1.1
Host: sandbox-api.violet.io
X-Violet-Token: text
X-Violet-App-Secret: text
X-Violet-App-Id: 1
Accept: */*

default

default response

{
  "id": 1,
  "account_type": "MERCHANT",
  "account_id": 1,
  "merchant_id": 1,
  "app_id": 1,
  "is_active": true,
  "country_code": "text",
  "payment_provider": "STRIPE",
  "payment_provider_account_id": "text",
  "payment_provider_account_type": "EXPRESS",
  "payment_provider_metadata": {
    "ANY_ADDITIONAL_PROPERTY": {}
  },
  "payment_provider_account": {},
  "date_deactivated": "2026-05-07T19:57:24.741Z",
  "errors": [
    {
      "id": 1,
      "error_code": 1,
      "error_message": "text",
      "resolved": true,
      "date_resolved": "2026-05-07T19:57:24.741Z",
      "date_created": "2026-05-07T19:57:24.741Z",
      "payout_account_id": 1
    }
  ],
  "date_created": "2026-05-07T19:57:24.741Z",
  "date_last_modified": "2026-05-07T19:57:24.741Z"
}