Beladed Docs
Help Sign in Create account

Beladed Payments API

Invoice - Search By Status

beta

Invoice - Search By Status through the reviewed Beladed Payments contract.

GET/api/payment/invoice/searchByStatus
curl --request GET 'https://api.beladed.dev/api/payment/invoice/searchByStatus?status=pending' \
  --header 'Accept: application/json' \
  --header 'X-Beladed-API-Key: BELADED_SECRET_KEY'

Parameters

statusqueryoptional

string — Filter by status.

Example: pending

Request body

No body is required.

Responses

200The request succeeded.
Responseapplication/json
Schema
{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "status": {
          "type": "string"
        }
      }
    },
    "requestId": {
      "type": "string"
    }
  }
}
{
  "data": {
    "id": "id_demo_001",
    "status": "available"
  },
  "requestId": "req_demo_001"
}

Errors

400invalid_request

The request did not satisfy the documented contract.

401authentication_required

The credential is missing or invalid.

403not_authorized

The account, product scope, permission, or origin is not eligible.

404not_found

The requested public or account-owned resource was not found.

429rate_limited

Retry after the current product limit resets.

Reliability

Idempotency
Read-only operation.
Pagination
Not applicable.
Rate limit
Subject to current account, product, and abuse-protection limits. Honor Retry-After when returned.
Webhook events
No related public event is declared.

Contract provenance

This operation is published from reviewed repository contracts. Source metadata is included for traceability without exposing internal implementation details.

Route owner
../beladed-api-cloudflare/src/functions/payment.js
Handler owner
../beladed-api-cloudflare/src/functions/core/PaymentInvoice.js
Verified
2026-07-11
Type to search the complete public documentation catalog.