Saltar al contenido principal
GET
List subscriptions
v1 · Base URL https://api.fintoc.com/v1

Autorizaciones

Authorization
string
header
requerido

Parámetros de consulta

since
string<date-time>

ISO 8601 datetime. Limits the results to subscriptions created at this datetime or after.

Ejemplo:

"2021-01-01T00:00:00.000Z"

until
string<date-time>

ISO 8601 datetime. Limits the results to subscriptions created at this datetime or before.

Ejemplo:

"2021-12-31T00:00:00.000Z"

page
integer

Page number to retrieve. Starts at 1.

Ejemplo:

1

per_page
integer

Number of subscriptions per page. Defaults to 30. The maximum is 300.

Ejemplo:

30

Respuesta

List of subscriptions for the current mode.

id
string
requerido

Unique identifier of the subscription.

Ejemplo:

"sub_m7N9rAWJS9dWDKEe"

object
any
requerido

Type of the object. Always subscription.

account
object
requerido

Represents the bank account a payer authorized for a subscription.

created_at
string<date-time>
requerido

ISO 8601 timestamp, in UTC, of when the subscription was created.

Ejemplo:

"2023-03-08T15:24:11Z"

mode
enum<string>
requerido

Mode of the object. live objects use real institution data, test objects use fake data for integration testing.

Opciones disponibles:
test,
live
Ejemplo:

"live"

reference_id
string
requerido

Identifier the payer's bank uses to display the subscription on the bank's portal. Defaults to the account holder's ID when not provided on creation.

Ejemplo:

"ABC12345"

status
enum<string>
requerido

Status of the subscription. One of pending (the bank has not confirmed the subscription yet), active (the subscription accepts charges), or canceled (the subscription no longer accepts charges).

Opciones disponibles:
pending,
active,
canceled
Ejemplo:

"active"