---
title: "Get Transactions Report"
method: POST
path: "/report"
---

# Get Transactions Report

`POST /report`

## Request

- Base URL: `https://api.myotp.app`
- URL: `https://api.myotp.app/report`
- Auth: none declared. Required headers: `X-API-Key`

Returns transactions within a specified date range. If `start_date` and `end_date` are omitted, the report will include the last 7 days of history. Supports pagination.

## Headers

- `X-API-Key` string, required

## Request body

- object
  - `start_date` string, date: Start date of the report in YYYY-MM-DD format. Optional; defaults to seven days ago.
  - `end_date` string, date: End date of the report in YYYY-MM-DD format. Optional; defaults to today.
  - `page` integer: The page number to fetch (optional)
  - `per_page` integer: The number of items per page (optional)

## Response `200`

Transactions report successfully retrieved

- object
  - `transactions` object[]
    - `message_id` string
    - `phone_number` string
    - `cost` number
    - `timestamp` string, date-time
    - `message_type` integer: Indicates whether this was to send an OTP or to Validate one
    - `description` string
    - `force_send` boolean: Indicates whether the transaction was force sent or not
    - `client_ip` string
    - `application` string
    - `created_at` string, date-time

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `429`: Too many requests from this IP address. The edge allows 100 requests a minute per client IP with a burst of 100, counted across every endpoint together, so sends and status checks share one budget. Accounts that ask for more are raised to 500 a minute; X-RateLimit-Limit on every response tells you which ceiling applies to you. Wait the number of seconds in Retry-After and repeat the request. Write to support@myotp.app with the addresses you call from and the peak you are designing for if you need a higher limit.

---

[API](https://skmtc.dev/myotp/apis/myotpapp-api.md) · [All operations](https://skmtc.dev/myotp/apis/myotpapp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/myotp/apis/myotpapp-api/revisions/95ed911fdece?raw)