Cuentas y espacios de trabajo

Obtener datos de facturación de la organización

Consulta el plan real de la organización, los precios derivados de las facturas y los cambios pendientes en el contexto del Workspace seleccionado y con la autoridad actual del propietario de la organización. Esta consulta no permite acogerse a una oferta ni cambiar la facturación.

POST /identity-api/commercial-access/billing/status

Contrato revisado: 2026-10-23 · sha256:794dfa010f25b5de

Leer en Markdown Descargar contrato público Descargar OpenAPI

Descripción general

Una respuesta HTTP exitosa puede indicar aceptación, no finalización. Para trabajo en segundo plano, guarda el ID devuelto y consulta la misma operación hasta que termine. Una publicación programada o aceptada solo está publicada cuando la plataforma lo confirma; un tiempo de espera agotado en el cliente no determina el resultado.

Autenticación y permisos

Clases de credenciales aceptadas: user_session, delegated_oauth, personal_access_token
Capacidad delegada: agent:operate
Rol mínimo del espacio de trabajo: Este contrato no exige un rol mínimo de espacio de trabajo; siguen aplicándose las comprobaciones de propiedad y permisos.
Alcance del acceso: Recursos a los que este usuario está autorizado a acceder
Se requiere consentimiento para todos los espacios de trabajo: No
Cambia el estado: No
Cuando la operación se completa: synchronous_http_response

Un token solo puede usar los derechos de su propietario. Cada solicitud comprueba pertenencia al espacio, propiedad del recurso, espacios elegidos y capacidades concedidas. Los perfiles core y full cambian qué herramientas se muestran; no conceden acceso.

Campos de solicitud

Obligatorio significa obligatorio dentro del objeto principal y la rama elegida. Un campo secundario obligatorio no convierte en obligatorio un objeto principal opcional. Las reglas y nombres de campos siguientes se copian del contrato.

Campos de solicitud
Campo / rama	Tipo / obligatorio	Restricciones
`$`	`object`Obligatorio en el objeto principal	`additionalProperties: false`
`workspace_id`	`string`Obligatorio en el objeto principal	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`

JSON Schema completo

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": [
    "workspace_id"
  ],
  "additionalProperties": false
}

Respuesta y finalización

Estados HTTP de éxito: 200. Cuando la operación se completa: synchronous_http_response.

Respuesta y finalización
Campo / rama	Tipo / obligatorio	Restricciones
`$`	`object`Obligatorio en el objeto principal	—
`contract_version`	`string`Obligatorio en el objeto principal	`const: "organization-commercial-billing/v1"`
`workspace_id`	`string`Obligatorio en el objeto principal	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`organization_id`	`string`Obligatorio en el objeto principal	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`plan`	`string`Obligatorio en el objeto principal	`enum: ["free","founding_pro","pro","team"]`
`plan_limits`	`object`Obligatorio en el objeto principal	—
`plan_limits`oneOf 1	`object`Obligatorio en el objeto principal	—
`plan_limits.plan`oneOf 1	`string`Obligatorio en el objeto principal	`const: "free"`
`plan_limits.included_human_seats`oneOf 1	`number \| null`Obligatorio en el objeto principal	—
`plan_limits.included_human_seats`oneOf 1 / anyOf 1	`number`Obligatorio en el objeto principal	`const: 1`
`plan_limits.included_human_seats`oneOf 1 / anyOf 2	`null`Obligatorio en el objeto principal	—
`plan_limits.connected_channel_limit`oneOf 1	`number`Obligatorio en el objeto principal	`const: 3`
`plan_limits.successful_destination_publishes_limit`oneOf 1	`number \| null`Obligatorio en el objeto principal	—
`plan_limits.successful_destination_publishes_limit`oneOf 1 / anyOf 1	`number`Obligatorio en el objeto principal	`const: 100`
`plan_limits.successful_destination_publishes_limit`oneOf 1 / anyOf 2	`null`Obligatorio en el objeto principal	—
`plan_limits.pending_scheduled_posts_limit`oneOf 1	`number`Obligatorio en el objeto principal	`const: 30`
`plan_limits.history_days`oneOf 1	`number`Obligatorio en el objeto principal	`const: 30`
`plan_limits.stripe_quantity`oneOf 1	`number`Obligatorio en el objeto principal	`const: 0`
`plan_limits`oneOf 2	`object`Obligatorio en el objeto principal	—
`plan_limits.plan`oneOf 2	`string`Obligatorio en el objeto principal	`const: "founding_pro"`
`plan_limits.included_human_seats`oneOf 2	`number \| null`Obligatorio en el objeto principal	—
`plan_limits.included_human_seats`oneOf 2 / anyOf 1	`number`Obligatorio en el objeto principal	`const: 5`
`plan_limits.included_human_seats`oneOf 2 / anyOf 2	`null`Obligatorio en el objeto principal	—
`plan_limits.connected_channel_limit`oneOf 2	`number`Obligatorio en el objeto principal	—
`plan_limits.connected_channel_limit`oneOf 2 / anyOf 1	`number`Obligatorio en el objeto principal	`const: 10`
`plan_limits.connected_channel_limit`oneOf 2 / anyOf 2	`number`Obligatorio en el objeto principal	`const: 20`
`plan_limits.successful_destination_publishes_limit`oneOf 2	`number \| null`Obligatorio en el objeto principal	—
`plan_limits.successful_destination_publishes_limit`oneOf 2 / anyOf 1	`number`Obligatorio en el objeto principal	`const: 1000`
`plan_limits.successful_destination_publishes_limit`oneOf 2 / anyOf 2	`null`Obligatorio en el objeto principal	—
`plan_limits.pending_scheduled_posts_limit`oneOf 2	`number`Obligatorio en el objeto principal	`const: 300`
`plan_limits.history_days`oneOf 2	`number`Obligatorio en el objeto principal	`const: 365`
`plan_limits.stripe_quantity`oneOf 2	`number`Obligatorio en el objeto principal	`const: 1`
`plan_limits`oneOf 3	`object`Obligatorio en el objeto principal	—
`plan_limits.plan`oneOf 3	`string`Obligatorio en el objeto principal	`const: "pro"`
`plan_limits.included_human_seats`oneOf 3	`null`Obligatorio en el objeto principal	—
`plan_limits.connected_channel_limit`oneOf 3	`number`Obligatorio en el objeto principal	`const: 10`
`plan_limits.successful_destination_publishes_limit`oneOf 3	`null`Obligatorio en el objeto principal	—
`plan_limits.unlimited_publishing_platforms`oneOf 3	`array`Obligatorio en el objeto principal	`minItems: 4` `maxItems: 4`
`plan_limits.pending_scheduled_posts_limit`oneOf 3	`number`Obligatorio en el objeto principal	`const: 300`
`plan_limits.history_days`oneOf 3	`number`Obligatorio en el objeto principal	`const: 365`
`plan_limits.stripe_quantity`oneOf 3	`number`Obligatorio en el objeto principal	`const: 1`
`plan_limits`oneOf 4	`object`Obligatorio en el objeto principal	—
`plan_limits.plan`oneOf 4	`string`Obligatorio en el objeto principal	`const: "team"`
`plan_limits.included_human_seats`oneOf 4	`null`Obligatorio en el objeto principal	—
`plan_limits.connected_channel_limit`oneOf 4	`number`Obligatorio en el objeto principal	`const: 20`
`plan_limits.successful_destination_publishes_limit`oneOf 4	`null`Obligatorio en el objeto principal	—
`plan_limits.unlimited_publishing_platforms`oneOf 4	`array`Obligatorio en el objeto principal	`minItems: 4` `maxItems: 4`
`plan_limits.pending_scheduled_posts_limit`oneOf 4	`number`Obligatorio en el objeto principal	`const: 300`
`plan_limits.history_days`oneOf 4	`number`Obligatorio en el objeto principal	`const: 365`
`plan_limits.stripe_quantity`oneOf 4	`number`Obligatorio en el objeto principal	`const: 1`
`pricing`	`object`Obligatorio en el objeto principal	—
`pricing`oneOf 1	`object`Obligatorio en el objeto principal	—
`pricing`oneOf 1 / oneOf 1	`object`Obligatorio en el objeto principal	—
`pricing.status`oneOf 1 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "available"`
`pricing.source_kind`oneOf 1 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "standard"`
`pricing.authority`oneOf 1 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "default_free"`
`pricing.plan`oneOf 1 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "free"`
`pricing.plan_version`oneOf 1 / oneOf 1	`number`Obligatorio en el objeto principal	—
`pricing.plan_version`oneOf 1 / oneOf 1 / anyOf 1	`number`Obligatorio en el objeto principal	`const: 1`
`pricing.plan_version`oneOf 1 / oneOf 1 / anyOf 2	`number`Obligatorio en el objeto principal	`const: 2`
`pricing.currency`oneOf 1 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "usd"`
`pricing.interval_unit`oneOf 1 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "month"`
`pricing.monthly_amount_cents`oneOf 1 / oneOf 1	`number`Obligatorio en el objeto principal	`const: 0`
`pricing`oneOf 1 / oneOf 2	`object`Obligatorio en el objeto principal	—
`pricing.status`oneOf 1 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "available"`
`pricing.source_kind`oneOf 1 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "standard"`
`pricing.authority`oneOf 1 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "verified_invoice"`
`pricing.plan`oneOf 1 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "pro"`
`pricing.plan_version`oneOf 1 / oneOf 2	`number`Obligatorio en el objeto principal	`const: 1`
`pricing.currency`oneOf 1 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "usd"`
`pricing.interval_unit`oneOf 1 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "month"`
`pricing.monthly_amount_cents`oneOf 1 / oneOf 2	`number`Obligatorio en el objeto principal	`const: 4000`
`pricing.verified_period`oneOf 1 / oneOf 2	`object`Obligatorio en el objeto principal	—
`pricing.verified_period.period_start`oneOf 1 / oneOf 2	`string`Obligatorio en el objeto principal	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`pricing.verified_period.period_end`oneOf 1 / oneOf 2	`string`Obligatorio en el objeto principal	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`pricing`oneOf 1 / oneOf 3	`object`Obligatorio en el objeto principal	—
`pricing.status`oneOf 1 / oneOf 3	`string`Obligatorio en el objeto principal	`const: "available"`
`pricing.source_kind`oneOf 1 / oneOf 3	`string`Obligatorio en el objeto principal	`const: "standard"`
`pricing.authority`oneOf 1 / oneOf 3	`string`Obligatorio en el objeto principal	`const: "verified_invoice"`
`pricing.plan`oneOf 1 / oneOf 3	`string`Obligatorio en el objeto principal	`const: "team"`
`pricing.plan_version`oneOf 1 / oneOf 3	`number`Obligatorio en el objeto principal	`const: 1`
`pricing.currency`oneOf 1 / oneOf 3	`string`Obligatorio en el objeto principal	`const: "usd"`
`pricing.interval_unit`oneOf 1 / oneOf 3	`string`Obligatorio en el objeto principal	`const: "month"`
`pricing.monthly_amount_cents`oneOf 1 / oneOf 3	`number`Obligatorio en el objeto principal	`const: 8000`
`pricing.verified_period`oneOf 1 / oneOf 3	`object`Obligatorio en el objeto principal	—
`pricing.verified_period.period_start`oneOf 1 / oneOf 3	`string`Obligatorio en el objeto principal	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`pricing.verified_period.period_end`oneOf 1 / oneOf 3	`string`Obligatorio en el objeto principal	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`pricing`oneOf 2	`object`Obligatorio en el objeto principal	—
`pricing`oneOf 2 / oneOf 1	`object`Obligatorio en el objeto principal	—
`pricing.status`oneOf 2 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "available"`
`pricing.source_kind`oneOf 2 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "promotional"`
`pricing.authority`oneOf 2 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "verified_invoice"`
`pricing.plan`oneOf 2 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "pro"`
`pricing.plan_version`oneOf 2 / oneOf 1	`number`Obligatorio en el objeto principal	`const: 2`
`pricing.currency`oneOf 2 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "usd"`
`pricing.interval_unit`oneOf 2 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "month"`
`pricing.monthly_amount_cents`oneOf 2 / oneOf 1	`number`Obligatorio en el objeto principal	`const: 1900`
`pricing.verified_period`oneOf 2 / oneOf 1	`object`Obligatorio en el objeto principal	—
`pricing.verified_period.period_start`oneOf 2 / oneOf 1	`string`Obligatorio en el objeto principal	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`pricing.verified_period.period_end`oneOf 2 / oneOf 1	`string`Obligatorio en el objeto principal	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`pricing`oneOf 2 / oneOf 2	`object`Obligatorio en el objeto principal	—
`pricing.status`oneOf 2 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "available"`
`pricing.source_kind`oneOf 2 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "promotional"`
`pricing.authority`oneOf 2 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "verified_invoice"`
`pricing.plan`oneOf 2 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "team"`
`pricing.plan_version`oneOf 2 / oneOf 2	`number`Obligatorio en el objeto principal	`const: 2`
`pricing.currency`oneOf 2 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "usd"`
`pricing.interval_unit`oneOf 2 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "month"`
`pricing.monthly_amount_cents`oneOf 2 / oneOf 2	`number`Obligatorio en el objeto principal	`const: 3900`
`pricing.verified_period`oneOf 2 / oneOf 2	`object`Obligatorio en el objeto principal	—
`pricing.verified_period.period_start`oneOf 2 / oneOf 2	`string`Obligatorio en el objeto principal	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`pricing.verified_period.period_end`oneOf 2 / oneOf 2	`string`Obligatorio en el objeto principal	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`pricing`oneOf 3	`object`Obligatorio en el objeto principal	—
`pricing`oneOf 3 / oneOf 1	`object`Obligatorio en el objeto principal	—
`pricing.status`oneOf 3 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "available"`
`pricing.source_kind`oneOf 3 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "legacy"`
`pricing.plan`oneOf 3 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "founding_pro"`
`pricing.plan_version`oneOf 3 / oneOf 1	`integer`Obligatorio en el objeto principal	`maximum: 2147483647` `exclusiveMinimum: 0`
`pricing.currency`oneOf 3 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "usd"`
`pricing.interval_unit`oneOf 3 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "month"`
`pricing.monthly_amount_cents`oneOf 3 / oneOf 1	`integer`Obligatorio en el objeto principal	`minimum: 0` `maximum: 2147483647`
`pricing.authority`oneOf 3 / oneOf 1	`string`Obligatorio en el objeto principal	`const: "legacy_commitment"`
`pricing`oneOf 3 / oneOf 2	`object`Obligatorio en el objeto principal	—
`pricing.status`oneOf 3 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "available"`
`pricing.source_kind`oneOf 3 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "legacy"`
`pricing.plan`oneOf 3 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "founding_pro"`
`pricing.plan_version`oneOf 3 / oneOf 2	`integer`Obligatorio en el objeto principal	`maximum: 2147483647` `exclusiveMinimum: 0`
`pricing.currency`oneOf 3 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "usd"`
`pricing.interval_unit`oneOf 3 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "month"`
`pricing.monthly_amount_cents`oneOf 3 / oneOf 2	`integer`Obligatorio en el objeto principal	`minimum: 0` `maximum: 2147483647`
`pricing.authority`oneOf 3 / oneOf 2	`string`Obligatorio en el objeto principal	`const: "verified_invoice"`
`pricing.verified_period`oneOf 3 / oneOf 2	`object`Obligatorio en el objeto principal	—
`pricing.verified_period.period_start`oneOf 3 / oneOf 2	`string`Obligatorio en el objeto principal	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`pricing.verified_period.period_end`oneOf 3 / oneOf 2	`string`Obligatorio en el objeto principal	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`pricing`oneOf 4	`object`Obligatorio en el objeto principal	—
`pricing.status`oneOf 4	`string`Obligatorio en el objeto principal	`const: "unavailable"`
`pricing.source_kind`oneOf 4	`string`Obligatorio en el objeto principal	`const: "manual"`
`pricing.authority`oneOf 4	`string`Obligatorio en el objeto principal	`const: "manual_grant"`
`pricing.plan`oneOf 4	`string`Obligatorio en el objeto principal	`enum: ["free","founding_pro","pro","team"]`
`pricing.plan_version`oneOf 4	`integer`Obligatorio en el objeto principal	`maximum: 2147483647` `exclusiveMinimum: 0`
`pricing.monthly_amount_cents`oneOf 4	`null`Obligatorio en el objeto principal	—
`pricing.reason_code`oneOf 4	`string`Obligatorio en el objeto principal	`const: "recurring_charge_not_observed"`
`pricing`oneOf 5	`object`Obligatorio en el objeto principal	—
`pricing.status`oneOf 5	`string`Obligatorio en el objeto principal	`const: "unavailable"`
`pricing.source_kind`oneOf 5	`string`Obligatorio en el objeto principal	`const: "unavailable"`
`pricing.authority`oneOf 5	`string`Obligatorio en el objeto principal	`const: "not_observed"`
`pricing.plan`oneOf 5	`string`Obligatorio en el objeto principal	`enum: ["free","founding_pro","pro","team"]`
`pricing.plan_version`oneOf 5	`integer \| null`Obligatorio en el objeto principal	—
`pricing.plan_version`oneOf 5 / anyOf 1	`integer`Obligatorio en el objeto principal	`maximum: 2147483647` `exclusiveMinimum: 0`
`pricing.plan_version`oneOf 5 / anyOf 2	`null`Obligatorio en el objeto principal	—
`pricing.monthly_amount_cents`oneOf 5	`null`Obligatorio en el objeto principal	—
`pricing.reason_code`oneOf 5	`string`Obligatorio en el objeto principal	`enum: ["current_period_proof_missing","pricing_authority_not_observed","catalog_binding_not_observed"]`
`purchase_options`	`object`Obligatorio en el objeto principal	—
`purchase_options`oneOf 1	`object`Obligatorio en el objeto principal	—
`purchase_options.status`oneOf 1	`string`Obligatorio en el objeto principal	`const: "unavailable"`
`purchase_options.reason_code`oneOf 1	`string`Obligatorio en el objeto principal	`enum: ["checkout_disabled","catalog_unconfigured"]`
`purchase_options`oneOf 2	`object`Obligatorio en el objeto principal	—
`purchase_options.status`oneOf 2	`string`Obligatorio en el objeto principal	`const: "configured"`
`purchase_options.catalog_version`oneOf 2	`string`Obligatorio en el objeto principal	`const: "organization-monthly-2026-10-24"`
`purchase_options.plans`oneOf 2	`object`Obligatorio en el objeto principal	—
`purchase_options.plans.pro`oneOf 2	`object`Obligatorio en el objeto principal	—
`purchase_options.plans.pro.plan`oneOf 2	`string`Obligatorio en el objeto principal	`const: "pro"`
`purchase_options.plans.pro.plan_version`oneOf 2	`number`Obligatorio en el objeto principal	`const: 1`
`purchase_options.plans.pro.currency`oneOf 2	`string`Obligatorio en el objeto principal	`const: "usd"`
`purchase_options.plans.pro.interval_unit`oneOf 2	`string`Obligatorio en el objeto principal	`const: "month"`
`purchase_options.plans.pro.monthly_amount_cents`oneOf 2	`number`Obligatorio en el objeto principal	`const: 4000`
`purchase_options.plans.team`oneOf 2	`object`Obligatorio en el objeto principal	—
`purchase_options.plans.team.plan`oneOf 2	`string`Obligatorio en el objeto principal	`const: "team"`
`purchase_options.plans.team.plan_version`oneOf 2	`number`Obligatorio en el objeto principal	`const: 1`
`purchase_options.plans.team.currency`oneOf 2	`string`Obligatorio en el objeto principal	`const: "usd"`
`purchase_options.plans.team.interval_unit`oneOf 2	`string`Obligatorio en el objeto principal	`const: "month"`
`purchase_options.plans.team.monthly_amount_cents`oneOf 2	`number`Obligatorio en el objeto principal	`const: 8000`
`pending_change`	`object`Obligatorio en el objeto principal	—
`pending_change`oneOf 1	`object`Obligatorio en el objeto principal	—
`pending_change.status`oneOf 1	`string`Obligatorio en el objeto principal	`const: "not_observed"`
`pending_change`oneOf 2	`object`Obligatorio en el objeto principal	—
`pending_change.status`oneOf 2	`string`Obligatorio en el objeto principal	`enum: ["scheduled","blocked_by_cancellation","terminated"]`
`pending_change.target_plan`oneOf 2	`string`Obligatorio en el objeto principal	`enum: ["pro","team"]`
`pending_change.target_plan_version`oneOf 2	`number`Obligatorio en el objeto principal	—
`pending_change.target_plan_version`oneOf 2 / anyOf 1	`number`Obligatorio en el objeto principal	`const: 1`
`pending_change.target_plan_version`oneOf 2 / anyOf 2	`number`Obligatorio en el objeto principal	`const: 2`
`pending_change.source_kind`oneOf 2	`string`Obligatorio en el objeto principal	`enum: ["standard","promotional"]`
`pending_change.currency`oneOf 2	`string`Obligatorio en el objeto principal	`const: "usd"`
`pending_change.interval_unit`oneOf 2	`string`Obligatorio en el objeto principal	`const: "month"`
`pending_change.monthly_amount_cents`oneOf 2	`number`Obligatorio en el objeto principal	—
`pending_change.monthly_amount_cents`oneOf 2 / anyOf 1	`number`Obligatorio en el objeto principal	`const: 4000`
`pending_change.monthly_amount_cents`oneOf 2 / anyOf 2	`number`Obligatorio en el objeto principal	`const: 8000`
`pending_change.monthly_amount_cents`oneOf 2 / anyOf 3	`number`Obligatorio en el objeto principal	`const: 1900`
`pending_change.monthly_amount_cents`oneOf 2 / anyOf 4	`number`Obligatorio en el objeto principal	`const: 3900`
`pending_change.effective_at`oneOf 2	`string`Obligatorio en el objeto principal	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`pending_change.activation`oneOf 2	`string`Obligatorio en el objeto principal	`const: "next_paid_invoice"`
`pending_change`oneOf 3	`object`Obligatorio en el objeto principal	—
`pending_change.status`oneOf 3	`string`Obligatorio en el objeto principal	`const: "unavailable"`
`pending_change.reason_code`oneOf 3	`string`Obligatorio en el objeto principal	`const: "pending_change_authority_not_observed"`
`continuous_lock`	`object`Obligatorio en el objeto principal	—
`continuous_lock`oneOf 1	`object`Obligatorio en el objeto principal	—
`continuous_lock.status`oneOf 1	`string`Obligatorio en el objeto principal	`const: "not_observed"`
`continuous_lock`oneOf 2	`object`Obligatorio en el objeto principal	—
`continuous_lock.status`oneOf 2	`string`Obligatorio en el objeto principal	`const: "none"`
`continuous_lock.reason_code`oneOf 2	`string`Obligatorio en el objeto principal	`const: "standard_subscription"`
`continuous_lock`oneOf 3	`object`Obligatorio en el objeto principal	—
`continuous_lock.status`oneOf 3	`string`Obligatorio en el objeto principal	`const: "active"`
`continuous_lock.source_kind`oneOf 3	`string`Obligatorio en el objeto principal	`const: "promotional"`
`continuous_lock.currency`oneOf 3	`string`Obligatorio en el objeto principal	`const: "usd"`
`continuous_lock.interval_unit`oneOf 3	`string`Obligatorio en el objeto principal	`const: "month"`
`continuous_lock.pro_monthly_amount_cents`oneOf 3	`number`Obligatorio en el objeto principal	`const: 1900`
`continuous_lock.team_monthly_amount_cents`oneOf 3	`number`Obligatorio en el objeto principal	`const: 3900`
`continuous_lock`oneOf 4	`object`Obligatorio en el objeto principal	—
`continuous_lock.status`oneOf 4	`string`Obligatorio en el objeto principal	`const: "terminated"`
`continuous_lock.ended_at`oneOf 4	`string`Obligatorio en el objeto principal	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`continuous_lock`oneOf 5	`object`Obligatorio en el objeto principal	—
`continuous_lock.status`oneOf 5	`string`Obligatorio en el objeto principal	`const: "unavailable"`
`continuous_lock.reason_code`oneOf 5	`string`Obligatorio en el objeto principal	`const: "commitment_authority_not_observed"`
`observed_at`	`string`Obligatorio en el objeto principal	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`

JSON Schema completo

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "contract_version": {
      "type": "string",
      "const": "organization-commercial-billing/v1"
    },
    "workspace_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "organization_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "plan": {
      "type": "string",
      "enum": [
        "free",
        "founding_pro",
        "pro",
        "team"
      ]
    },
    "plan_limits": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "plan": {
              "type": "string",
              "const": "free"
            },
            "included_human_seats": {
              "anyOf": [
                {
                  "type": "number",
                  "const": 1
                },
                {
                  "type": "null"
                }
              ]
            },
            "connected_channel_limit": {
              "type": "number",
              "const": 3
            },
            "successful_destination_publishes_limit": {
              "anyOf": [
                {
                  "type": "number",
                  "const": 100
                },
                {
                  "type": "null"
                }
              ]
            },
            "pending_scheduled_posts_limit": {
              "type": "number",
              "const": 30
            },
            "history_days": {
              "type": "number",
              "const": 30
            },
            "stripe_quantity": {
              "type": "number",
              "const": 0
            }
          },
          "required": [
            "plan",
            "included_human_seats",
            "connected_channel_limit",
            "successful_destination_publishes_limit",
            "pending_scheduled_posts_limit",
            "history_days",
            "stripe_quantity"
          ]
        },
        {
          "type": "object",
          "properties": {
            "plan": {
              "type": "string",
              "const": "founding_pro"
            },
            "included_human_seats": {
              "anyOf": [
                {
                  "type": "number",
                  "const": 5
                },
                {
                  "type": "null"
                }
              ]
            },
            "connected_channel_limit": {
              "anyOf": [
                {
                  "type": "number",
                  "const": 10
                },
                {
                  "type": "number",
                  "const": 20
                }
              ]
            },
            "successful_destination_publishes_limit": {
              "anyOf": [
                {
                  "type": "number",
                  "const": 1000
                },
                {
                  "type": "null"
                }
              ]
            },
            "pending_scheduled_posts_limit": {
              "type": "number",
              "const": 300
            },
            "history_days": {
              "type": "number",
              "const": 365
            },
            "stripe_quantity": {
              "type": "number",
              "const": 1
            }
          },
          "required": [
            "plan",
            "included_human_seats",
            "connected_channel_limit",
            "successful_destination_publishes_limit",
            "pending_scheduled_posts_limit",
            "history_days",
            "stripe_quantity"
          ]
        },
        {
          "type": "object",
          "properties": {
            "plan": {
              "type": "string",
              "const": "pro"
            },
            "included_human_seats": {
              "type": "null"
            },
            "connected_channel_limit": {
              "type": "number",
              "const": 10
            },
            "successful_destination_publishes_limit": {
              "type": "null"
            },
            "unlimited_publishing_platforms": {
              "type": "array",
              "prefixItems": [
                {
                  "type": "string",
                  "const": "instagram"
                },
                {
                  "type": "string",
                  "const": "facebook"
                },
                {
                  "type": "string",
                  "const": "threads"
                },
                {
                  "type": "string",
                  "const": "youtube"
                }
              ],
              "items": false,
              "minItems": 4,
              "maxItems": 4
            },
            "pending_scheduled_posts_limit": {
              "type": "number",
              "const": 300
            },
            "history_days": {
              "type": "number",
              "const": 365
            },
            "stripe_quantity": {
              "type": "number",
              "const": 1
            }
          },
          "required": [
            "plan",
            "included_human_seats",
            "connected_channel_limit",
            "successful_destination_publishes_limit",
            "unlimited_publishing_platforms",
            "pending_scheduled_posts_limit",
            "history_days",
            "stripe_quantity"
          ]
        },
        {
          "type": "object",
          "properties": {
            "plan": {
              "type": "string",
              "const": "team"
            },
            "included_human_seats": {
              "type": "null"
            },
            "connected_channel_limit": {
              "type": "number",
              "const": 20
            },
            "successful_destination_publishes_limit": {
              "type": "null"
            },
            "unlimited_publishing_platforms": {
              "type": "array",
              "prefixItems": [
                {
                  "type": "string",
                  "const": "instagram"
                },
                {
                  "type": "string",
                  "const": "facebook"
                },
                {
                  "type": "string",
                  "const": "threads"
                },
                {
                  "type": "string",
                  "const": "youtube"
                }
              ],
              "items": false,
              "minItems": 4,
              "maxItems": 4
            },
            "pending_scheduled_posts_limit": {
              "type": "number",
              "const": 300
            },
            "history_days": {
              "type": "number",
              "const": 365
            },
            "stripe_quantity": {
              "type": "number",
              "const": 1
            }
          },
          "required": [
            "plan",
            "included_human_seats",
            "connected_channel_limit",
            "successful_destination_publishes_limit",
            "unlimited_publishing_platforms",
            "pending_scheduled_posts_limit",
            "history_days",
            "stripe_quantity"
          ]
        }
      ]
    },
    "pricing": {
      "oneOf": [
        {
          "oneOf": [
            {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "const": "available"
                },
                "source_kind": {
                  "type": "string",
                  "const": "standard"
                },
                "authority": {
                  "type": "string",
                  "const": "default_free"
                },
                "plan": {
                  "type": "string",
                  "const": "free"
                },
                "plan_version": {
                  "anyOf": [
                    {
                      "type": "number",
                      "const": 1
                    },
                    {
                      "type": "number",
                      "const": 2
                    }
                  ]
                },
                "currency": {
                  "type": "string",
                  "const": "usd"
                },
                "interval_unit": {
                  "type": "string",
                  "const": "month"
                },
                "monthly_amount_cents": {
                  "type": "number",
                  "const": 0
                }
              },
              "required": [
                "status",
                "source_kind",
                "authority",
                "plan",
                "plan_version",
                "currency",
                "interval_unit",
                "monthly_amount_cents"
              ]
            },
            {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "const": "available"
                },
                "source_kind": {
                  "type": "string",
                  "const": "standard"
                },
                "authority": {
                  "type": "string",
                  "const": "verified_invoice"
                },
                "plan": {
                  "type": "string",
                  "const": "pro"
                },
                "plan_version": {
                  "type": "number",
                  "const": 1
                },
                "currency": {
                  "type": "string",
                  "const": "usd"
                },
                "interval_unit": {
                  "type": "string",
                  "const": "month"
                },
                "monthly_amount_cents": {
                  "type": "number",
                  "const": 4000
                },
                "verified_period": {
                  "type": "object",
                  "properties": {
                    "period_start": {
                      "type": "string",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                      "format": "date-time"
                    },
                    "period_end": {
                      "type": "string",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                      "format": "date-time"
                    }
                  },
                  "required": [
                    "period_start",
                    "period_end"
                  ]
                }
              },
              "required": [
                "status",
                "source_kind",
                "authority",
                "plan",
                "plan_version",
                "currency",
                "interval_unit",
                "monthly_amount_cents",
                "verified_period"
              ]
            },
            {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "const": "available"
                },
                "source_kind": {
                  "type": "string",
                  "const": "standard"
                },
                "authority": {
                  "type": "string",
                  "const": "verified_invoice"
                },
                "plan": {
                  "type": "string",
                  "const": "team"
                },
                "plan_version": {
                  "type": "number",
                  "const": 1
                },
                "currency": {
                  "type": "string",
                  "const": "usd"
                },
                "interval_unit": {
                  "type": "string",
                  "const": "month"
                },
                "monthly_amount_cents": {
                  "type": "number",
                  "const": 8000
                },
                "verified_period": {
                  "type": "object",
                  "properties": {
                    "period_start": {
                      "type": "string",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                      "format": "date-time"
                    },
                    "period_end": {
                      "type": "string",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                      "format": "date-time"
                    }
                  },
                  "required": [
                    "period_start",
                    "period_end"
                  ]
                }
              },
              "required": [
                "status",
                "source_kind",
                "authority",
                "plan",
                "plan_version",
                "currency",
                "interval_unit",
                "monthly_amount_cents",
                "verified_period"
              ]
            }
          ]
        },
        {
          "oneOf": [
            {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "const": "available"
                },
                "source_kind": {
                  "type": "string",
                  "const": "promotional"
                },
                "authority": {
                  "type": "string",
                  "const": "verified_invoice"
                },
                "plan": {
                  "type": "string",
                  "const": "pro"
                },
                "plan_version": {
                  "type": "number",
                  "const": 2
                },
                "currency": {
                  "type": "string",
                  "const": "usd"
                },
                "interval_unit": {
                  "type": "string",
                  "const": "month"
                },
                "monthly_amount_cents": {
                  "type": "number",
                  "const": 1900
                },
                "verified_period": {
                  "type": "object",
                  "properties": {
                    "period_start": {
                      "type": "string",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                      "format": "date-time"
                    },
                    "period_end": {
                      "type": "string",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                      "format": "date-time"
                    }
                  },
                  "required": [
                    "period_start",
                    "period_end"
                  ]
                }
              },
              "required": [
                "status",
                "source_kind",
                "authority",
                "plan",
                "plan_version",
                "currency",
                "interval_unit",
                "monthly_amount_cents",
                "verified_period"
              ]
            },
            {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "const": "available"
                },
                "source_kind": {
                  "type": "string",
                  "const": "promotional"
                },
                "authority": {
                  "type": "string",
                  "const": "verified_invoice"
                },
                "plan": {
                  "type": "string",
                  "const": "team"
                },
                "plan_version": {
                  "type": "number",
                  "const": 2
                },
                "currency": {
                  "type": "string",
                  "const": "usd"
                },
                "interval_unit": {
                  "type": "string",
                  "const": "month"
                },
                "monthly_amount_cents": {
                  "type": "number",
                  "const": 3900
                },
                "verified_period": {
                  "type": "object",
                  "properties": {
                    "period_start": {
                      "type": "string",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                      "format": "date-time"
                    },
                    "period_end": {
                      "type": "string",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                      "format": "date-time"
                    }
                  },
                  "required": [
                    "period_start",
                    "period_end"
                  ]
                }
              },
              "required": [
                "status",
                "source_kind",
                "authority",
                "plan",
                "plan_version",
                "currency",
                "interval_unit",
                "monthly_amount_cents",
                "verified_period"
              ]
            }
          ]
        },
        {
          "oneOf": [
            {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "const": "available"
                },
                "source_kind": {
                  "type": "string",
                  "const": "legacy"
                },
                "plan": {
                  "type": "string",
                  "const": "founding_pro"
                },
                "plan_version": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 2147483647
                },
                "currency": {
                  "type": "string",
                  "const": "usd"
                },
                "interval_unit": {
                  "type": "string",
                  "const": "month"
                },
                "monthly_amount_cents": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 2147483647
                },
                "authority": {
                  "type": "string",
                  "const": "legacy_commitment"
                }
              },
              "required": [
                "status",
                "source_kind",
                "plan",
                "plan_version",
                "currency",
                "interval_unit",
                "monthly_amount_cents",
                "authority"
              ]
            },
            {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "const": "available"
                },
                "source_kind": {
                  "type": "string",
                  "const": "legacy"
                },
                "plan": {
                  "type": "string",
                  "const": "founding_pro"
                },
                "plan_version": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 2147483647
                },
                "currency": {
                  "type": "string",
                  "const": "usd"
                },
                "interval_unit": {
                  "type": "string",
                  "const": "month"
                },
                "monthly_amount_cents": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 2147483647
                },
                "authority": {
                  "type": "string",
                  "const": "verified_invoice"
                },
                "verified_period": {
                  "type": "object",
                  "properties": {
                    "period_start": {
                      "type": "string",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                      "format": "date-time"
                    },
                    "period_end": {
                      "type": "string",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                      "format": "date-time"
                    }
                  },
                  "required": [
                    "period_start",
                    "period_end"
                  ]
                }
              },
              "required": [
                "status",
                "source_kind",
                "plan",
                "plan_version",
                "currency",
                "interval_unit",
                "monthly_amount_cents",
                "authority",
                "verified_period"
              ]
            }
          ]
        },
        {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "const": "unavailable"
            },
            "source_kind": {
              "type": "string",
              "const": "manual"
            },
            "authority": {
              "type": "string",
              "const": "manual_grant"
            },
            "plan": {
              "type": "string",
              "enum": [
                "free",
                "founding_pro",
                "pro",
                "team"
              ]
            },
            "plan_version": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 2147483647
            },
            "monthly_amount_cents": {
              "type": "null"
            },
            "reason_code": {
              "type": "string",
              "const": "recurring_charge_not_observed"
            }
          },
          "required": [
            "status",
            "source_kind",
            "authority",
            "plan",
            "plan_version",
            "monthly_amount_cents",
            "reason_code"
          ]
        },
        {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "const": "unavailable"
            },
            "source_kind": {
              "type": "string",
              "const": "unavailable"
            },
            "authority": {
              "type": "string",
              "const": "not_observed"
            },
            "plan": {
              "type": "string",
              "enum": [
                "free",
                "founding_pro",
                "pro",
                "team"
              ]
            },
            "plan_version": {
              "anyOf": [
                {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 2147483647
                },
                {
                  "type": "null"
                }
              ]
            },
            "monthly_amount_cents": {
              "type": "null"
            },
            "reason_code": {
              "type": "string",
              "enum": [
                "current_period_proof_missing",
                "pricing_authority_not_observed",
                "catalog_binding_not_observed"
              ]
            }
          },
          "required": [
            "status",
            "source_kind",
            "authority",
            "plan",
            "plan_version",
            "monthly_amount_cents",
            "reason_code"
          ]
        }
      ]
    },
    "purchase_options": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "const": "unavailable"
            },
            "reason_code": {
              "type": "string",
              "enum": [
                "checkout_disabled",
                "catalog_unconfigured"
              ]
            }
          },
          "required": [
            "status",
            "reason_code"
          ]
        },
        {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "const": "configured"
            },
            "catalog_version": {
              "type": "string",
              "const": "organization-monthly-2026-10-24"
            },
            "plans": {
              "type": "object",
              "properties": {
                "pro": {
                  "type": "object",
                  "properties": {
                    "plan": {
                      "type": "string",
                      "const": "pro"
                    },
                    "plan_version": {
                      "type": "number",
                      "const": 1
                    },
                    "currency": {
                      "type": "string",
                      "const": "usd"
                    },
                    "interval_unit": {
                      "type": "string",
                      "const": "month"
                    },
                    "monthly_amount_cents": {
                      "type": "number",
                      "const": 4000
                    }
                  },
                  "required": [
                    "plan",
                    "plan_version",
                    "currency",
                    "interval_unit",
                    "monthly_amount_cents"
                  ]
                },
                "team": {
                  "type": "object",
                  "properties": {
                    "plan": {
                      "type": "string",
                      "const": "team"
                    },
                    "plan_version": {
                      "type": "number",
                      "const": 1
                    },
                    "currency": {
                      "type": "string",
                      "const": "usd"
                    },
                    "interval_unit": {
                      "type": "string",
                      "const": "month"
                    },
                    "monthly_amount_cents": {
                      "type": "number",
                      "const": 8000
                    }
                  },
                  "required": [
                    "plan",
                    "plan_version",
                    "currency",
                    "interval_unit",
                    "monthly_amount_cents"
                  ]
                }
              },
              "required": [
                "pro",
                "team"
              ]
            }
          },
          "required": [
            "status",
            "catalog_version",
            "plans"
          ]
        }
      ]
    },
    "pending_change": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "const": "not_observed"
            }
          },
          "required": [
            "status"
          ]
        },
        {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "scheduled",
                "blocked_by_cancellation",
                "terminated"
              ]
            },
            "target_plan": {
              "type": "string",
              "enum": [
                "pro",
                "team"
              ]
            },
            "target_plan_version": {
              "anyOf": [
                {
                  "type": "number",
                  "const": 1
                },
                {
                  "type": "number",
                  "const": 2
                }
              ]
            },
            "source_kind": {
              "type": "string",
              "enum": [
                "standard",
                "promotional"
              ]
            },
            "currency": {
              "type": "string",
              "const": "usd"
            },
            "interval_unit": {
              "type": "string",
              "const": "month"
            },
            "monthly_amount_cents": {
              "anyOf": [
                {
                  "type": "number",
                  "const": 4000
                },
                {
                  "type": "number",
                  "const": 8000
                },
                {
                  "type": "number",
                  "const": 1900
                },
                {
                  "type": "number",
                  "const": 3900
                }
              ]
            },
            "effective_at": {
              "type": "string",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "format": "date-time"
            },
            "activation": {
              "type": "string",
              "const": "next_paid_invoice"
            }
          },
          "required": [
            "status",
            "target_plan",
            "target_plan_version",
            "source_kind",
            "currency",
            "interval_unit",
            "monthly_amount_cents",
            "effective_at",
            "activation"
          ]
        },
        {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "const": "unavailable"
            },
            "reason_code": {
              "type": "string",
              "const": "pending_change_authority_not_observed"
            }
          },
          "required": [
            "status",
            "reason_code"
          ]
        }
      ]
    },
    "continuous_lock": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "const": "not_observed"
            }
          },
          "required": [
            "status"
          ]
        },
        {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "const": "none"
            },
            "reason_code": {
              "type": "string",
              "const": "standard_subscription"
            }
          },
          "required": [
            "status",
            "reason_code"
          ]
        },
        {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "const": "active"
            },
            "source_kind": {
              "type": "string",
              "const": "promotional"
            },
            "currency": {
              "type": "string",
              "const": "usd"
            },
            "interval_unit": {
              "type": "string",
              "const": "month"
            },
            "pro_monthly_amount_cents": {
              "type": "number",
              "const": 1900
            },
            "team_monthly_amount_cents": {
              "type": "number",
              "const": 3900
            }
          },
          "required": [
            "status",
            "source_kind",
            "currency",
            "interval_unit",
            "pro_monthly_amount_cents",
            "team_monthly_amount_cents"
          ]
        },
        {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "const": "terminated"
            },
            "ended_at": {
              "type": "string",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "format": "date-time"
            }
          },
          "required": [
            "status",
            "ended_at"
          ]
        },
        {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "const": "unavailable"
            },
            "reason_code": {
              "type": "string",
              "const": "commitment_authority_not_observed"
            }
          },
          "required": [
            "status",
            "reason_code"
          ]
        }
      ]
    },
    "observed_at": {
      "type": "string",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "format": "date-time"
    }
  },
  "required": [
    "contract_version",
    "workspace_id",
    "organization_id",
    "plan",
    "plan_limits",
    "pricing",
    "purchase_options",
    "pending_change",
    "continuous_lock",
    "observed_at"
  ]
}

Errores y reintentos seguros

Comprueba el estado HTTP y el cuerpo de respuesta. Un error de validación 400 puede contener un ZodError; los errores del controlador usan los campos error, message y code. Conserva request_id o x-request-id para el diagnóstico, sin credenciales. Corrige los errores de acceso 401/403 antes de reintentar y respeta Retry-After para 429. Si una escritura es incierta o devuelve 5xx, consulta primero el resultado existente. Reutiliza una clave de idempotencia solo donde se admita; el comportamiento de reintento varía por operación y no garantiza una entrega exactamente una vez.

Guía de solución de problemas

Ejemplos

Estos ejemplos usan valores ficticios comprobados con los esquemas. Sustituye los IDs por otros autorizados, los archivos multimedia por recursos listos y las fechas por tu hora de publicación confirmada. Comprueba la elegibilidad de la cuenta antes de enviar una escritura. Esta página no envía solicitudes API.

Establece SOSOAPI_ACCESS_TOKEN en tu servidor con una credencial aceptada por esta operación y mantenla fuera del código del navegador. Para un agente, usa sosoapi auth login para iniciar sesión en el navegador y deja a la CLI renovar sus credenciales.

request.json

{
  "workspace_id": "11111111-1111-4111-8111-111111111111"
}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/identity-api/commercial-access/billing/status" \
  -H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

JavaScript

// Server-side JavaScript. Do not print tokens or credential-bearing responses.
const token = process.env.SOSOAPI_ACCESS_TOKEN;
if (!token) throw new Error("Set an accepted credential for this operation");
const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/identity-api/commercial-access/billing/status", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "workspace_id": "11111111-1111-4111-8111-111111111111"
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.

CLI

npx sosoapi api post /identity-api/commercial-access/billing/status < request.json

Ejemplo de respuesta sintética

{
  "contract_version": "organization-commercial-billing/v1",
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "organization_id": "11111111-1111-4111-8111-111111111111",
  "plan": "free",
  "plan_limits": {
    "plan": "free",
    "included_human_seats": null,
    "connected_channel_limit": 3,
    "successful_destination_publishes_limit": null,
    "pending_scheduled_posts_limit": 30,
    "history_days": 30,
    "stripe_quantity": 0
  },
  "pricing": {
    "status": "available",
    "source_kind": "standard",
    "authority": "default_free",
    "plan": "free",
    "plan_version": 1,
    "currency": "usd",
    "interval_unit": "month",
    "monthly_amount_cents": 0
  },
  "purchase_options": {
    "status": "unavailable",
    "reason_code": "checkout_disabled"
  },
  "pending_change": {
    "status": "not_observed"
  },
  "continuous_lock": {
    "status": "not_observed"
  },
  "observed_at": "2099-01-15T09:00:00Z"
}

MCP: sosoapi_get_organization_billing

Todas las operaciones API Autenticación y permisos