DOM360
Financeiro

Listar as versões de preço de um cliente

GET
/billing/profiles/{tenant_id}/terms-versions

As versões de preço do cliente, da mais antiga para a mais nova: a de base (o que valia antes da primeira alteração com vigência, effective_from nulo), as que já valeram e as agendadas (promoted_at nulo). É o que responde "quanto este cliente pagava em tal mês".

Autorização

bearer billing:read
AutorizaçãoBearer <token>

Credencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.

Em: header

Escopo: billing:read

Parâmetros de caminho

tenant_id*integer

Id do cliente

Formatoint64

Parâmetros de consulta

cursor?string

Cursor opaco devolvido em page.next_cursor da página anterior. Omita para começar do início.

limit?integer

Tamanho da página. Padrão 50; o máximo é o da coleção: 200, ou até 500 nas coleções de itens pequenos.

Formatoint32
Intervalo0 <= value

Corpo da resposta

application/json

application/json

curl -X GET "https://example.com/billing/profiles/0/terms-versions"
{  "data": [    {      "actor_email": "string",      "created_at": "2019-08-24T14:15:22Z",      "custom_fields": [        "string"      ],      "effective_from": "string",      "promoted_at": "2019-08-24T14:15:22Z",      "reason": "string",      "terms": {        "currency": "string",        "due_day": 0,        "platform_monthly_cents": 0,        "receptive_channel_unit_cents": 0,        "text_additional_cents": 0,        "text_ia_allowance_cents": 0,        "text_principal_cents": 0,        "voice_additional_cents": 0,        "voice_ia_allowance_cents": 0,        "voice_principal_cents": 0      }    }  ],  "page": {    "has_more": true,    "next_cursor": "string"  }}