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 unidades con licencia cambia durante ese periodo, la respuesta incluye varios registros de la misma suscripción.

La respuesta solo incluye suscripciones de pospago.

Parámetros de ruta¶

org_id string obligatorio

ID de la organización cuyo historial de suscripciones se va a consultar.

Parámetros de consulta¶

start date-time

Inicio del periodo del informe. Utilice el formato RFC 3339. El periodo debe abarcar entre 1 y 40 días.

end date-time

Fin del periodo del informe. Utilice el formato RFC 3339. Debe ser al menos una hora anterior al momento 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 contiene la respuesta a una consulta del historial de suscripciones.

items array of objects

object

SubscriptionHistoryItem representa un intervalo durante el cual se mantiene constante el número de unidades con licencia de un elemento de suscripción.

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 de este tipo de elemento (por ejemplo, 10 recursos o 5 licencias adicionales de almacenamiento, cada una con una cuota de 100 GB).

amount int64

Importe total, en céntimos, facturado por este elemento durante el intervalo correspondiente. Puede cambiar si el plan de precios se modifica durante el 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"
    }
  ]
}