# Get payment instruction

Returns the full payment instruction identified by instruction_id under the given client_id. The response includes the instruction id, a list of scheduled payments (each with amount, target account, and optional clientRef), any bankTransferRef provided by the payment system, and the current status (such as new, processing, or completed). Use this endpoint to track the overall lifecycle and settlement state of a particular payment instruction.

Endpoint: GET /v2/partner/client/{client_id}/instruction/{instruction_id}
Version: 2.0.0
Security: oAuth

## Path parameters:

  - `client_id` (string, required)
    The ID of requested client.
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `instruction_id` (string, required)
    The ID of requested instruction.
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

## Response 200 fields (application/json):

  - `id` (string)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `type` (string)
    The type of instruction
    Example: "autogiro"

  - `instructions` (array)
    Array of payment instructions

  - `instructions.amount` (number, required)
    The amount of the payment
    Example: 110

  - `instructions.account` (string, required)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `instructions.clientRef` (string, required)
    Client specified reference for keeping track of payment.
Value is copied to the clientRef of transactions

  - `bankTransferRef` (string,null)
    The text to use in a bank transfer. Not applicable for autogiro
    Example: "REF-12345"

  - `status` (string)
    instruction status

## Response 400 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "invalid_request"

  - `error_description` (string)
    Description of error

## Response 401 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "unauthorized"

  - `error_description` (string)
    Description of error

## Response 403 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "forbidden"

  - `error_description` (string)
    Description of error

## Response 500 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "server_error"

  - `error_description` (string)
    Description of error

## Response 503 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "service_unavailable"

  - `error_description` (string)
    Description of error