# Retrieve the payout details of a historic resource

Query by transaction reference and entity to retrieve a Payout.

Endpoint: GET /payouts/query
Version: 2
Security: BasicAuth

## Security:

  - `BasicAuth` (unknown)
    http basic

## Query parameters:

  - `transactionReference` (string, required)
    A unique reference generated by you, used to identify a payout throughout its lifecycle

  - `entity` (string, required)
    merchant entity

## Response 200:

  - `200` (unknown)
    Returns a payout resource, provided one matches the transaction and entity references.

## Response 200 fields (application/vnd.worldpay.payouts-v2+json):

  - `curies` (array, required)

  - `curies.href` (string, required)

  - `curies.name` (string, required)

  - `curies.templated` (boolean, required)

  - `outcome` (string, required)
    outcome of payouts query request

  - `receivedAt` (string, required)
    A timestamp of receivedAt

## Response 200 examples:

  - `Basic Disbursement: An existing resource is retrieved with outcome 'requestReceived'` (unknown)
    Basic Disbursement: An existing resource is retrieved with outcome 'requestReceived'

  - `Basic Disbursement: An existing resource is retrieved with outcome 'refused'` (unknown)
    Basic Disbursement: An existing resource is retrieved with outcome 'refused'

  - `Basic Disbursement: An existing resource is retrieved with outcome 'error'` (unknown)
    Basic Disbursement: An existing resource is retrieved with outcome 'error'

  - `Fast Access: An existing resource is retrieved with outcome 'requested'` (unknown)
    Fast Access: An existing resource is retrieved with outcome 'requested'

  - `Fast Access: An existing resource is retrieved with outcome 'pending'` (unknown)
    Fast Access: An existing resource is retrieved with outcome 'pending'

  - `Fast Access: An existing resource is retrieved with outcome 'approved'` (unknown)
    Fast Access: An existing resource is retrieved with outcome 'approved'

  - `Fast Access: An existing resource is retrieved with outcome 'disbursed'` (unknown)
    Fast Access: An existing resource is retrieved with outcome 'disbursed'

  - `Fast Access: An existing resource is retrieved with outcome 'refused'` (unknown)
    Fast Access: An existing resource is retrieved with outcome 'refused'

  - `Fast Access: An existing resource is retrieved with outcome 'error'` (unknown)
    Fast Access: An existing resource is retrieved with outcome 'error'