Skip to main content
GET
/
card
/
auth_capture
/
authorize?status=AUTHORIZED&page=
{page}
&size=
{size}
&from_date=
{from_date}
&to_date=
{to_date}
Get All Authorizations
curl --request GET \
  --url 'https://api.payaza.africa/live/card/auth_capture/authorize?status=AUTHORIZED&page={page}&size={size}&from_date={from_date}&to_date={to_date}' \
  --header 'Authorization: <api-key>'
{
  "authorizations": [
    {
      "authorization_reference": "AUTH-1234567890",
      "status": "AUTHORIZED",
      "authorization_amount": 100,
      "captured_amount": 0,
      "remaining_amount": 100,
      "currency": "NGN",
      "authorization_code": "123456",
      "expires_at": "2025-01-19T10:30:00",
      "created_at": "2025-01-12T10:30:00",
      "updated_at": "2025-01-12T10:30:00",
      "captured_at": null,
      "voided_at": null,
      "card_last_4": "2346",
      "card_brand": "MASTERCARD",
      "order_reference": "ORD-001",
      "merchant_reference": "MR-001",
      "customer_email": "customer@example.com",
      "customer_name": "John Doe",
      "error_reason": null,
      "void_reason": null
    }
  ],
  "page": 0,
  "size": 20,
  "total_elements": 1,
  "total_pages": 1,
  "has_next": false,
  "has_previous": false
}

Authorizations

​
Authorization
string
header
required

Payaza {{Public API Key in Base 64}}

Path Parameters

​
status
string

Authorization status to filter results (e.g. AUTHORIZED, PENDING, FAILED).

​
from_date
string

Start date for filtering records, in yyyy-MM-dd HH:mm:ss format.

​
to_date
string

End date for filtering records, in yyyy-MM-dd HH:mm:ss format.

​
page
number

Page number for paginated results.

​
size
number

The number of records to return per page.

Response

Get All Authorizations Response

​
status
string | null

Error status (present in error responses).

Example:

"ERROR"

​
message
string | null

Error message details (present in error responses).

Example:

"Invalid date format. Use ISO 8601 format (e.g., 2024-01-01T00:00:00)"

​
authorizations
object[]

List of authorization records.

​
page
integer

Current page index (0-based).

Example:

0

​
size
integer

Number of items per page.

Example:

20

​
total_elements
integer

Total number of authorization records found.

Example:

1

​
total_pages
integer

Total number of pages available.

Example:

1

​
has_next
boolean

Indicates if there is a next page.

Example:

false

​
has_previous
boolean

Indicates if there is a previous page.

Example:

false