list subscription bills

GET

/v1/subscriptions/{id}/bills

curl --request GET \
  --url https://api.flowpayra.com/v1/subscriptions/example/bills \
  --header 'X-Api-Key: <X-Api-Key>' \
  --header 'X-Nonce: <X-Nonce>' \
  --header 'X-Signature: <X-Signature>' \
  --header 'X-Timestamp: <X-Timestamp>'

Authorizations

• HmacApiKey
• HmacSignature
• HmacTimestamp
• HmacNonce

Parameters

Path Parameters

id

required

string

>= 1 characters <= 128 characters

Responses

200

Successful response

Media typeapplication/json

object

bills

required

Array<object>

object

id

required

string

>= 1 characters <= 128 characters

payment_id

required

string

>= 1 characters <= 128 characters

amount

required

string

<= 128 characters /^(0|[1-9][0-9]*)(\.[0-9]+)?$/

raw_amount

required

string

<= 78 characters /^(0|[1-9][0-9]*)$/

currency_id

required

string

>= 1 characters <= 128 characters

currency_chain_id

required

string

>= 1 characters <= 128 characters

chain_id

required

string

>= 1 characters <= 128 characters

status

required

string

>= 1 characters <= 64 characters

attempt_count

required

integer format: int32

tx_hash

required

One of:

string

string

null

null

period_start

required

string format: date-time

period_end

required

string format: date-time

created_at

required

string format: date-time

Example^generated

{
  "bills": [
    {
      "id": "example",
      "payment_id": "example",
      "amount": "example",
      "raw_amount": "example",
      "currency_id": "example",
      "currency_chain_id": "example",
      "chain_id": "example",
      "status": "example",
      "attempt_count": 1,
      "tx_hash": "example",
      "period_start": "2026-04-15T12:00:00Z",
      "period_end": "2026-04-15T12:00:00Z",
      "created_at": "2026-04-15T12:00:00Z"
    }
  ]
}

400

Stable API error

Media typeapplication/json

object

code

required

string

message

required

string

details

Example^generated

{
  "code": "example",
  "message": "example",
  "details": "example"
}

401

Stable API error

Media typeapplication/json

object

code

required

string

message

required

string

details

Example^generated

{
  "code": "example",
  "message": "example",
  "details": "example"
}

404

Stable API error

Media typeapplication/json

object

code

required

string

message

required

string

details

Example^generated

{
  "code": "example",
  "message": "example",
  "details": "example"
}

409

Stable API error

Media typeapplication/json

object

code

required

string

message

required

string

details

Example^generated

{
  "code": "example",
  "message": "example",
  "details": "example"
}

422

Stable API error

Media typeapplication/json

object

code

required

string

message

required

string

details

Example^generated

{
  "code": "example",
  "message": "example",
  "details": "example"
}