Obtener el historial de suscripciones.¶

Método¶

GET https://papi.afi.ai/api/v1/orgs/{org_id}/licensing/subscriptions/history

Descripción¶

Devuelve el uso histórico de las suscripciones de la organización durante el periodo solicitado. Si la cantidad de licencias cambia durante ese periodo, la respuesta incluye varios registros de la misma suscripción.

La respuesta solo incluye suscripciones pospago.

Parámetros de ruta¶

org_id string obligatorio

ID de la organización cuyo historial de suscripciones se obtendrá.

Parámetros de consulta¶

start date-time

Inicio de la ventana del informe. Utilice el formato RFC 3339. La ventana debe abarcar entre 1 y 40 días.

end date-time

Fin de la ventana del informe. Utilice el formato RFC 3339. Debe ser al menos una hora anterior a la hora actual.

curl

curl -X GET \
    -H 'Authorization: {api-key}' \
    https://papi.afi.ai/api/v1/orgs/{org_id}/licensing/subscriptions/history

Esquema de respuesta correcta (200)¶

object

SubscriptionHistoryResult es la respuesta a una solicitud del historial de suscripciones.

items array of objects

object

SubscriptionHistoryItem representa un intervalo de tiempo durante el cual la cantidad de elementos con licencia de la suscripción permanece constante.

sub_id string

ID de la suscripción.

tenant_id string

ID del inquilino al que está asignada la suscripción.

start date-time

Inicio del periodo. Utilice el formato RFC 3339.

end date-time

Fin del periodo. Utilice el formato RFC 3339.

kind string

Tipo de elemento de suscripción (por ejemplo, recurso, almacenamiento, nodo, máquina virtual o base de datos).

qty int64

Número de unidades con licencia para el tipo de elemento (por ejemplo, 10 recursos o 5 licencias de almacenamiento adicional, cada una de las cuales concede una cuota de 100 GB).

amount int64

Importe total, en céntimos, facturado por este elemento durante el intervalo correspondiente. Este importe puede cambiar si el plan de precios se modifica a mitad del periodo de facturación (antes de emitir la factura).

Ejemplo de respuesta¶

{
  "items": [
    {
      "sub_id": "string",
      "tenant_id": "string",
      "start": "2025-11-19T20:02:49.311313Z",
      "end": "2025-11-19T20:02:49.311313Z",
      "kind": "string",
      "qty": "int64-as-string",
      "amount": "int64-as-string"
    }
  ]
}