# Accept Transfer

Accept a requested transfer. This will execute the transfer and may not be reversible depending on the owner of the destination account

Endpoint: POST /v1/transfers/{transfer_id}/accept
Version: 1.1.2
Security: OAuth2Flow

## Path parameters:

  - `id` (string, required)
    Transfer ID

## Header parameters:

  - `Authorization` (string)
    OAuth bearer token (see authentication flows)

  - `x-l2f-request-id` (string)
    Optional Unique ID per request, useful for fault resolution/diagnosis and audit.

  - `x-l2f-idempotency-id` (string)
    Unique ID used to safely retry an operation. See idempotency section for more details.

  - `x-signature` (string)
    Client signature to validate the provence of the API request. See signing section for more details.

  - `x-timestamp` (string)
    Current timestamp, represented AS unix epoch seconds. Mandatory when x-signature is provided.

## Response 200 fields (application/json):

  - `data` (object, required)

  - `data.id` (string, required)
    Unique ID of the transfer request, to be used to accept the transfer and lookup status

  - `data.status` (string, required)
    Status of the transfer. Cannot be modified directly by the client. 
* REQUESTED - Transfer request is created and has passed validation. It must be accepted at which point it will be executed. 
* ACCEPTED - Transfer request has been accepted and is waiting execution. At this point it cannot be cancelled.  
* EXPIRED - Occurs when a transfer request was not accepted within a reasonable time frame. The transfer cannot be replayed from this state.  
* CANCELLED - Transfer request was cancelled. Only available prior to acceptance. The transfer request cannot be replayed from this state.  
* EXECUTED -  Transfer request has been executed, it is completed with all ledger entries performed.  
* REJECTED - Transfer request was rejected and cannot be executed.
    Enum: "REQUESTED", "ACCEPTED", "EXPIRED", "CANCELLED", "EXECUTED", "REJECTED"

## Response 400 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description

## Response 401 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description

## Response 404 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description

## Response 500 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description