Get transaction details

Get transaction details by id, foreign_id, or txid. Include only one of these parameters in your request.

GET /transactions/info

cURL

foreign_id

curl --request GET \
  --url https://app.cryptoprocessing.com/api/v2/transactions/info \
  --header 'Content-Type: application/json' \
  --header 'X-Processing-Key: <api-key>' \
  --header 'X-Processing-Signature: <x-processing-signature>' \
  --data '
{
  "foreign_id": "test_foreign_id_0250"
}
'

200

Deposit

{
  "id": 1,
  "end_user_reference": "12345",
  "type": "deposit",
  "crypto_address": {
    "id": 1,
    "currency": "BTC",
    "address": "39mFf3X46YzUtfdwVQpYXPCMydc74ccbAZ",
    "foreign_id": "12345",
    "tag": null
  },
  "currency_sent": {
    "currency": "BTC",
    "amount": "6.53157512"
  },
  "currency_received": {
    "currency": "BTC",
    "amount": "6.53157512",
    "amount_minus_fee": "6.5119800"
  },
  "transactions": [
    {
      "id": 1,
      "currency": "BTC",
      "transaction_type": "blockchain",
      "type": "deposit",
      "address": "39mFf3X46YzUtfdwVQpYXPCMydc74ccbAZ",
      "tag": null,
      "amount": "6.53157512",
      "txid": "3950ad8149421a850d01dff88f024810e363ac18c9e8dd9bc0b9116e7937ad93",
      "riskscore": "0.5",
      "confirmations": "3"
    }
  ],
  "fees": [
    {
      "type": "deposit",
      "currency": "BTC",
      "amount": "0.01959472"
    }
  ],
  "error": "",
  "status": "confirmed"
}

You can only request data for transactions that were authorized using your API and secret key.

Authorizations

X-Processing-Key · string · header · required

Your API key.

Headers

X-Processing-Signature · string · required

Hex-encoded HMAC-SHA512 signature of the request body, generated using your secret key.

Body

application/json

By internal ID

By foreign ID

By txid

id · integer · required

Internal transaction ID.

Example:

717535

Response

200

application/json

OK

id · integer<int32> · required

Required range: x >= 1

Example:

717535

type · string · required

Transaction type.

transactions · object[] · required

Transaction entries. Each entry has a transaction_type that determines which fields are present:

• blockchain: On-chain transactions (has address, tag, txid, riskscore, confirmations)
• internal: Internal transfers (has address, tag, txid, confirmations)
• exchange: Currency exchanges (has currency_to, amount_to)

Show child attributes

fees · object[] · required

Show child attributes

status · enum<string> · required

Transaction status. Note: internal statuses are mapped before returning:

• processing and verifying are returned as not_confirmed
• error is returned as cancelled
• rejected is returned as cancelled

Available options: cancelled, confirmed, declined, not_confirmed, pending

foreign_id · string

This transaction's unique identifier in your system.

end_user_reference · string

End user reference. Present only when KYC data was provided.

crypto_address · object

Address details. Present only when entry has an associated address.

Show child attributes

currency_sent · object

Sent currency details. Present for confirmed, verifying, or processing transactions.

Show child attributes

currency_received · object

Received currency details. Present for confirmed, verifying, or processing transactions.

Show child attributes

error · string | null

Error message. Null or empty string for successful transactions.

additional_details · object

Additional transaction details. Present only when available.