BxBytix

POST/v1/payouts/info

Query Payout

Look up a payout by payout_id or id. If both are sent, id wins.

Request body

idstringoptional

Bytix payout id returned at create. If present, payout_id is used only as fallback.

payout_idstringoptional

Your payout ID. Used when id is omitted. Send at least one of the two.

Headers

Authorizationheaderrequired

Bearer pk_… from dashboard Settings → Developer.

Content-Typeheaderoptional

application/json on POST bodies. Not required on GET.

Response data

Same data shape as create. HTTP 200 on success.

idstringrequired

Bytix payout id. Stable. Use it with query if you stored it.

payout_idstringrequired

Your payout id. Unique per workspace. Repeating it on create returns this same payout.

amountstringrequired

USD amount as a decimal string.

currencystringrequired

Always USD.

assetstringrequired

Ticker sent on-chain, for example USDT.

networkstringrequired

Network display name, for example Tron.

addressstringrequired

Destination address.

crypto_amountstringoptional

Quoted crypto amount for the requested USD, as a decimal string.

fee_amountstringoptional

Fees of the withdrawal, in the payout asset.

fee_paid_bystringoptional

merchant: the fees come from your balance and the full amount is sent. customer: they are taken off what is sent.

net_amountstringoptional

Crypto sent on-chain: crypto_amount when you pay the fees, crypto_amount minus fee_amount when the customer does.

quote_ratestringoptional

USD per unit of the asset at the market price when the withdrawal was requested.

statusstringrequired

awaiting_approval, pending (approved, being sent), submitted, completed, rejected, or failed.

txidstringoptional

On-chain transaction id when completed, else null.

payer_idstringrequired

Your user id from create.

demobooleanrequired

True when the payout was created with a demo key. Simulated: nothing is sent and no balance changes.

created_atstringrequired

ISO-8601 create time.

Errors

Failures still return JSON. Read code, not only the HTTP status. Full table: Errors.

40100HTTP 401optional

Missing or invalid API key.

40400HTTP 404optional

No payout for this workspace.