> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beinfi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultar conta de teste

> Diz se a conta de teste já foi reivindicada e até quando vale. Não leva chave e não devolve chaves.




## OpenAPI

````yaml /api-reference/openapi.pt-BR.json get /public/v1/claimables/{claimableID}
openapi: 3.1.0
info:
  title: Infi API
  version: 0.0.1
  description: >
    A API REST do Infi: catálogo, clientes, medição de uso, assinaturas,
    faturas,

    pagamentos e checkout.


    **Autenticação.** Envie a chave secreta em `Authorization: Bearer sk_test_…`

    (sandbox) ou `sk_live_…` (produção). O prefixo da chave decide o ambiente.
    As

    rotas de checkout (`/pay/*`) e `/public/*` não levam chave: rodam no
    navegador

    de quem paga.


    **Idempotência.** Toda requisição que altera dados exige o header

    `Idempotency-Key`. Uma repetição com a mesma chave devolve a resposta
    original

    em vez de executar de novo.


    **Valores.** Dinheiro e quantidades trafegam como texto decimal (`"150.00"`,

    `"0.0001"`), nunca como número de ponto flutuante.


    **Erros.** O corpo traz `error_code` (estável, use para decidir), `message`

    (para pessoas) e `tracer_id` (envie ao suporte). Erros de limite de
    requisições

    e de idempotência vêm aninhados em `error`, com `code` e `request_id`.
servers:
  - url: https://api-sandbox.beinfi.com
    description: Sandbox
  - url: https://api.beinfi.com
    description: Produção
security:
  - bearerAuth: []
tags:
  - name: Catálogo
  - name: Clientes
  - name: Medição de uso
  - name: Assinaturas
  - name: Faturas
  - name: Pagamentos
  - name: Checkout
  - name: Cupons
  - name: Cobrança
  - name: Conta
  - name: Webhooks
  - name: Conta de teste
  - name: Rail
  - name: Lojas
paths:
  /public/v1/claimables/{claimableID}:
    get:
      tags:
        - Conta de teste
      summary: Consultar conta de teste
      description: >
        Diz se a conta de teste já foi reivindicada e até quando vale. Não leva
        chave e não devolve chaves.
      operationId: getClaimable
      parameters:
        - in: path
          name: claimableID
          required: true
          schema:
            type: string
            format: uuid
          description: O `id` devolvido na criação da conta de teste.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TestAccountStatus'
          description: O estado da conta de teste.
      security: []
components:
  schemas:
    TestAccountStatus:
      type: object
      required:
        - id
        - status
        - tenantSlug
        - ref
        - expiresAt
      properties:
        id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - UNCLAIMED
            - CLAIMED
          description: '`UNCLAIMED` ou `CLAIMED`.'
        tenantSlug:
          type: string
          description: O identificador público da conta.
        accountName:
          type: string
        productId:
          type: string
          format: uuid
          description: O produto inicial.
        ref:
          type: string
          enum:
            - lovable
            - mcp
            - cursor
            - cli
          description: De onde veio a conta.
        expiresAt:
          type: string
          format: date-time
          description: Prazo para o claim.
        claimedAt:
          type: string
          format: date-time
          description: Quando a conta foi reivindicada.
      description: O estado público de uma conta de teste, sem chaves.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Chave secreta da conta: `Authorization: Bearer sk_test_…` ou
        `sk_live_…`. Use só no servidor.

````