> ## Documentation Index
> Fetch the complete documentation index at: https://developer.payem.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get transactions

> List transactions available to the authenticated Partner.



## OpenAPI

````yaml /openapi/partner-schema.yml get /api/partner/v1/transactions
openapi: 3.0.3
info:
  title: PayEm Partner API
  version: '1.0'
servers:
  - url: https://app.payemcard.com
    description: Production
  - url: https://stage.payemcard.com
    description: Staging
security: []
paths:
  /api/partner/v1/transactions:
    get:
      tags:
        - transactions
      summary: Get transactions
      description: List transactions available to the authenticated Partner.
      operationId: transactions_retrieve
      parameters:
        - in: query
          name: card_owner_id
          schema:
            type: integer
          description: >-
            Filter by card owner id. Only applied when `card_type` is also sent.
            If sent without `card_type`, this param is ignored.
        - in: query
          name: card_type
          schema:
            type: string
            enum:
              - EMPLOYEE
              - SINGLE-USE
              - VENDOR
          description: >-
            Filter by card type. Can be sent alone. When combined with
            `card_owner_id`, both filters are applied (AND).
        - in: query
          name: date_from
          schema:
            type: string
          description: >-
            Inclusive UTC start date (YYYY-MM-DD) of the transaction time. Can
            be sent without date_to.
        - in: query
          name: date_to
          schema:
            type: string
          description: >-
            Inclusive UTC end date (YYYY-MM-DD) of the transaction time.
            Includes the entire day. Can be sent without date_from.
        - in: query
          name: page
          schema:
            type: integer
            default: 1
          description: Page number
        - in: query
          name: page_size
          schema:
            type: integer
            default: 50
          description: >-
            Number of results per page. Defaults to 50. Values above 100 are
            clamped to 100.
        - in: query
          name: receipt
          schema:
            type: string
            enum:
              - 'false'
              - 'true'
          description: >-
            Filter by receipt presence. `true` returns transactions with a
            receipt; `false` returns transactions without a receipt. Omit to
            return all transactions.
        - in: query
          name: search
          schema:
            type: string
            default: ''
          description: Search string
        - in: query
          name: subsidiary_id
          schema:
            type: integer
      responses:
        '200':
          headers:
            X-Trace-Id:
              schema:
                type: string
              description: >-
                Unique identifier for tracing this request through PayEm
                systems.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionPageResponse'
          description: ''
      security:
        - PayemOAuthAccessToken: []
components:
  schemas:
    TransactionPageResponse:
      type: object
      properties:
        count:
          type: integer
        current_page:
          type: integer
        page_size:
          type: integer
        results:
          type: array
          items:
            $ref: '#/components/schemas/TransactionResponse'
      required:
        - count
        - current_page
        - page_size
        - results
    TransactionResponse:
      type: object
      properties:
        created_at:
          type: string
          format: date-time
        id:
          type: string
        card_id:
          type: string
        merchant:
          $ref: '#/components/schemas/Merchant'
        amount:
          $ref: '#/components/schemas/Amount'
        status:
          type: string
        decline_info:
          allOf:
            - $ref: '#/components/schemas/DeclineInfo'
          nullable: true
        receipt:
          allOf:
            - $ref: '#/components/schemas/TransactionReceipt'
          nullable: true
      required:
        - amount
        - card_id
        - created_at
        - id
        - merchant
        - status
    Merchant:
      type: object
      properties:
        name:
          type: string
        descriptor:
          type: string
        mcc:
          allOf:
            - $ref: '#/components/schemas/MCC'
          nullable: true
      required:
        - descriptor
        - name
    Amount:
      type: object
      properties:
        usd:
          type: number
          format: double
        original:
          type: object
          additionalProperties: {}
      required:
        - original
        - usd
    DeclineInfo:
      type: object
      properties:
        decline_code:
          type: string
        decline_reason:
          type: string
    TransactionReceipt:
      type: object
      properties:
        url:
          type: string
        expires_at:
          type: string
          format: date-time
      required:
        - url
    MCC:
      type: object
      properties:
        code:
          type: string
        card_network:
          type: string
      required:
        - card_network
        - code
  securitySchemes:
    PayemOAuthAccessToken:
      type: http
      scheme: bearer
      description: Short-lived OAuth 2.0 access token. Tokens expire after five minutes.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.