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

# Get Account Transactions

> Fetches all transactions of the specified account according to the query parameters.



## OpenAPI

````yaml openapi.json get /accounts/{id}/transactions
openapi: 3.1.0
info:
  title: Sudo Sandbox API
  version: '1.0'
servers:
  - url: https://api.sandbox.sudo.cards
security:
  - sec0: []
paths:
  /accounts/{id}/transactions:
    get:
      summary: Get Account Transactions
      description: >-
        Fetches all transactions of the specified account according to the query
        parameters.
      operationId: get-account-transactions
      parameters:
        - name: id
          in: path
          description: The `_id` of the account you wish to fetch the transactions for.
          schema:
            type: string
          required: true
        - name: page
          in: query
          description: Specifies the position the response data should begin from.
          schema:
            type: integer
            format: int32
            default: 0
        - name: limit
          in: query
          description: The number of transactions to fetch.
          schema:
            type: integer
            format: int32
            default: 100
        - name: fromDate
          in: query
          description: This is the start date of the date range.
          schema:
            type: string
            format: date
        - name: toDate
          in: query
          description: This is the end date of the date range.
          schema:
            type: string
            format: date
      responses:
        '200':
          description: Account transactions fetched successfully.
          headers:
            X-Powered-By:
              schema:
                type: string
              example: Express
            Access-Control-Allow-Origin:
              schema:
                type: string
              example: '*'
            X-RateLimit-Limit:
              schema:
                type: integer
              example: '250000'
            X-RateLimit-Remaining:
              schema:
                type: integer
              example: '249999'
            X-RateLimit-Reset:
              schema:
                type: integer
              example: '0'
            Content-Type:
              schema:
                type: string
              example: application/json; charset=utf-8
            ETag:
              schema:
                type: string
              example: W/"2dd-sfRBgLV2BqnKnzwqFCi2UGdBgUQ"
            Connection:
              schema:
                type: string
              example: keep-alive
            Keep-Alive:
              schema:
                type: string
              example: timeout=5
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    description: >-
                      Status code of the response. `200` indicates a successful
                      request.
                  message:
                    type: string
                    description: Human-readable description of the result.
                  data:
                    type: array
                    description: Array of objects for the requested page.
                    items:
                      type: object
                      properties:
                        _id:
                          type: string
                          description: Unique identifier of the object.
                        business:
                          type: string
                          description: Identifier of the business that owns this object.
                        customer:
                          type: string
                          description: >-
                            Associated customer — an id, or a summary object on
                            nested resources.
                        card:
                          type: string
                          description: >-
                            Associated card — an id, or a summary object on
                            nested resources.
                        account:
                          type: string
                          description: >-
                            Associated account — an id, or a summary object on
                            nested resources.
                        authorization:
                          type: string
                          description: >-
                            Identifier of the authorization this transaction
                            belongs to.
                        type:
                          type: string
                          description: Type of the object.
                        amount:
                          type: integer
                          description: Amount in the minor currency unit (e.g. kobo).
                        fee:
                          type: integer
                          description: Fee charged, in the minor currency unit.
                        vat:
                          type: integer
                          description: VAT charged, in the minor currency unit.
                        currency:
                          type: string
                          description: ISO 4217 currency code (e.g. `NGN`).
                        merchantAmount:
                          type: integer
                          description: Amount in the merchant's currency.
                        merchantCurrency:
                          type: string
                          description: Merchant's ISO 4217 currency code.
                        status:
                          type: string
                          description: Current status of the object.
                        transactionMetadata:
                          type: object
                          description: Channel and reference metadata for the transaction.
                          properties:
                            channel:
                              type: string
                              description: >-
                                Channel the transaction occurred on (`web`,
                                `pos`, `atm`).
                            type:
                              type: string
                              description: Type of the object.
                            reference:
                              type: string
                              description: Unique reference assigned to the object.
                        createdAt:
                          type: string
                          format: date-time
                          description: ISO 8601 timestamp of when the object was created.
                        updatedAt:
                          type: string
                          format: date-time
                          description: >-
                            ISO 8601 timestamp of when the object was last
                            updated.
                        __v:
                          type: integer
                          description: Internal document version (Mongo).
                  pagination:
                    type: object
                    description: Pagination metadata for the result set.
                    properties:
                      total:
                        type: integer
                        description: >-
                          Total number of records matching the query across all
                          pages.
                      pages:
                        type: integer
                        description: Total number of pages available for the current query.
                      page:
                        type: integer
                        description: >-
                          Current page index (zero-based; matches the `page`
                          query parameter).
                      limit:
                        type: integer
                        description: >-
                          Maximum number of records returned per page (matches
                          the `limit` query parameter).
              example:
                statusCode: 200
                message: Account transactions fetched successfully.
                data:
                  - _id: 6840c1aa2b3c4d5e6f700333
                    business: 670cec9d25852ba485d74273
                    customer: 64a1b2c3d4e5f6a7b8c9d0e1
                    card: 6418eb71a37e405064694518
                    account: 67974b365c184d20fc340889
                    authorization: 6840c1aa2b3c4d5e6f700222
                    type: purchase
                    amount: 5000
                    fee: 0
                    vat: 0
                    currency: NGN
                    merchantAmount: 5000
                    merchantCurrency: NGN
                    status: completed
                    transactionMetadata:
                      channel: web
                      type: purchase
                      reference: TRX-250604-2156
                    createdAt: '2025-06-04T21:05:26.115Z'
                    updatedAt: '2025-06-05T09:15:00.000Z'
                    __v: 0
                pagination:
                  total: 8
                  pages: 1
                  page: 0
                  limit: 50
        '400':
          description: Validation error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    description: >-
                      Status code of the response. `200` indicates a successful
                      request.
                  message:
                    type: string
                    description: Human-readable description of the result.
                  data:
                    nullable: true
                    description: Always `null` for error responses.
              example:
                statusCode: 400
                message: Invalid account id.
                data: null
        '401':
          description: Authentication failed — missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    description: >-
                      Status code of the response. `200` indicates a successful
                      request.
                  message:
                    type: string
                    description: Human-readable description of the result.
                  data:
                    nullable: true
                    description: Response payload.
              example:
                statusCode: 401
                message: >-
                  Unauthorized. Provide a valid API key in the Authorization
                  header.
                data: null
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: Authorization
      x-bearer-format: bearer
      x-default: '{{APIKey}}'

````