Get Instruction By Reference

Testing Env

https://api.uat.sokin.com

GET

/instructions/{instruction_reference}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Responses

🟢200OK

application/json

Successful Response

Body

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.uat.sokin.com/instructions/' \
--header 'x-api-version: 2025-12-01' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "external_reference": "I-Payment-a95469e5-869c-450b-a2c6-6ba8fae4a004",
    "version": 2,
    "created_at": "2025-12-02T01:31:45.187Z",
    "status": "Created",
    "instruction_type": "Payment",
    "corporate_currency_account": "CA-GBP-d30ebb2c-5f63-4d97-abd5-3ae238867c45-1",
    "quote_id": null,
    "amount": "329.99",
    "beneficiary_reference": "fafa4ff7-66b0-4d67-bb0d-fa9b98a3da76",
    "sender_reference": "Invoice 001",
    "payment_purpose": "Commercial",
    "source_currency": "GBP",
    "destination_currency": "GBP",
    "sokin_fx_fee": "0",
    "sokin_transaction_fee": "5",
    "reseller_transaction_fee": "0",
    "corporate_reference": "corp_18902284",
    "payment_reference": "01KLL52-K8889U"
}

Modified at 2025-12-02 14:05:10

GetInstructionRequestResponse

GetInstructionResponse