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

# Get proposal

> Draft: specification in progress. Endpoints and fields may change.

Returns a proposal, with movements and, once approved, unsigned
transactions. Scope: `read`.


<Warning>Draft: specification in progress. Endpoints and fields may change.</Warning>


## OpenAPI

````yaml /en/api/openapi.yaml get /propostas/{id}
openapi: 3.1.0
info:
  title: TESA API
  version: 0.1.0-rascunho
  description: >
    **Draft: specification in progress. Endpoints and fields may change.**


    TESA's B2B treasury infrastructure API. USDC comes in through Circle's CCTP

    (Ethereum and Solana) and is allocated to tokenized Treasuries (USDY and
    BUIDL).

    The API is non-custodial: it never receives a private key or a signed
    transaction.

    It returns unsigned transactions and approval requests, and the signer is
    the

    company or its custodian.


    Resource paths, field names, event names and error codes are in Portuguese
    by

    design. Amounts are USDC decimal strings with two decimal places, dates are
    ISO

    8601 UTC and lists use cursor pagination (`limite` and `apos`). All example

    values are illustrative.
  contact:
    name: TESA
    email: contact@t3sa.com
    url: https://t3sa.com
servers:
  - url: https://api.t3sa.com/v1
    description: Production (proposed URL, not live yet)
  - url: https://sandbox.api.t3sa.com/v1
    description: Sandbox (proposed URL, not live yet)
security:
  - bearerAuth: []
tags:
  - name: Organization
    description: The client company, owner of all keys and resources.
  - name: Wallets
    description: >-
      Company wallets linked by public address. No key ever passes through the
      API.
  - name: Positions
    description: A snapshot of the cash position, the same as in the dashboard.
  - name: Allocation policy
    description: Assets approved by the company and the proportion between them.
  - name: Proposals
    description: >-
      Every allocation movement starts as a proposal and only executes with
      approval.
  - name: Redemptions
    description: Return of USDC balance to a linked company wallet.
  - name: Records
    description: On-chain audit trail, with the hash of each transaction.
  - name: Yield and charges
    description: Yield calculated per period and the fee charged on it.
  - name: Webhooks
    description: Destinations that receive TESA events.
paths:
  /propostas/{id}:
    get:
      tags:
        - Proposals
      summary: Get proposal
      description: |
        Draft: specification in progress. Endpoints and fields may change.

        Returns a proposal, with movements and, once approved, unsigned
        transactions. Scope: `read`.
      operationId: obterProposta
      parameters:
        - $ref: '#/components/parameters/IdProposta'
      responses:
        '200':
          description: Proposal.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Proposta'
        '401':
          $ref: '#/components/responses/NaoAutenticado'
        '404':
          $ref: '#/components/responses/NaoEncontrado'
components:
  parameters:
    IdProposta:
      name: id
      in: path
      required: true
      description: Proposal identifier, prefixed with `prop_`.
      schema:
        type: string
        examples:
          - prop_8f2a1c
  schemas:
    Proposta:
      type: object
      properties:
        id:
          type: string
          examples:
            - prop_8f2a1c
        tipo:
          type: string
          enum:
            - alocacao
            - rebalanceamento
        status:
          type: string
          enum:
            - pendente
            - aprovada
            - rejeitada
            - executada
        origem:
          type: string
          enum:
            - tesa
            - cliente
        motivo:
          type: string
        movimentos:
          type: array
          items:
            $ref: '#/components/schemas/Movimento'
        alocacao_resultante:
          type: array
          items:
            $ref: '#/components/schemas/AtivoValor'
        transacoes:
          type: array
          description: Available from the `aprovada` status onward.
          items:
            $ref: '#/components/schemas/Transacao'
        criada_em:
          type: string
          format: date-time
        decidida_em:
          type:
            - string
            - 'null'
          format: date-time
        executada_em:
          type:
            - string
            - 'null'
          format: date-time
    Movimento:
      type: object
      properties:
        de:
          $ref: '#/components/schemas/Ativo'
        para:
          $ref: '#/components/schemas/Ativo'
        valor:
          $ref: '#/components/schemas/Valor'
    AtivoValor:
      type: object
      properties:
        ativo:
          $ref: '#/components/schemas/Ativo'
        valor:
          $ref: '#/components/schemas/Valor'
        percentual:
          type: number
          examples:
            - 60
    Transacao:
      type: object
      description: Unsigned transaction, delivered to the company's custodian for signing.
      properties:
        id:
          type: string
          examples:
            - tx_01
        rede:
          $ref: '#/components/schemas/Rede'
        carteira_id:
          type: string
        status:
          type: string
          enum:
            - aguardando_assinatura
            - transmitida
            - confirmada
            - falhou
        payload_nao_assinado:
          type: string
          examples:
            - 0x02f8...
        tx_hash:
          type:
            - string
            - 'null'
    Erro:
      type: object
      properties:
        erro:
          type: object
          properties:
            codigo:
              type: string
              examples:
                - saldo_insuficiente
            mensagem:
              type: string
            campo:
              type:
                - string
                - 'null'
            requisicao_id:
              type: string
              examples:
                - req_9d8c7b
    Ativo:
      type: string
      enum:
        - USDY
        - BUIDL
    Valor:
      type: string
      pattern: ^\d+\.\d{2}$
      description: USDC amount, a decimal string with two decimal places.
      examples:
        - '842110.00'
    Rede:
      type: string
      enum:
        - ethereum
        - solana
  responses:
    NaoAutenticado:
      description: Missing, invalid or revoked key, or invalid HMAC signature.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Erro'
    NaoEncontrado:
      description: Resource does not exist or belongs to another organization.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Erro'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        The organization's API key (`tesa_live_...` in production,
        `tesa_test_...` in the sandbox).

````