Consultar suscripción y uso del equipo

GET

/billing/subscription

const url = 'https://api.dev.lade.com.mx/billing/subscription?teamId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.dev.lade.com.mx/billing/subscription?teamId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \
  --header 'Authorization: Bearer <token>'

Devuelve el plan actual del equipo, su uso de viajes del periodo, y metadatos de la suscripción de Stripe (estado, fecha de fin de periodo, días restantes, si el trial expiró).

Authorizations

cognitoAuth

Parameters

Query Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

Responses

200

Estado de la suscripción

application/json

object

plan

string

status

string

subscriptionId

string

tripsUsed

integer

tripsLimit

-1 significa ilimitado

integer

tripsRemaining

integer

usagePercent

number

currentPeriodEnd

string

nullable

daysLeft

integer

nullable

trialEndsAt

string

nullable

isTrialExpired

boolean

Example

{
  "plan": "STARTER",
  "status": "active",
  "subscriptionId": "sub_1AbCDeFGhIJKlmn",
  "tripsUsed": 12,
  "tripsLimit": 50,
  "tripsRemaining": 38,
  "usagePercent": 24,
  "currentPeriodEnd": "2026-08-26T00:00:00+00:00",
  "daysLeft": 31,
  "trialEndsAt": "",
  "isTrialExpired": false
}

400

Solicitud inválida

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Validation failed",
  "field": "email",
  "message": "Invalid email format"
}

403

Sin permisos

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Forbidden",
  "message": "You don't have permission to access this resource"
}

404

Recurso no encontrado

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Not found",
  "message": "Resource not found"
}