Celcoin Proposal API

The Proposal API from Celcoin — 2 operation(s) for proposal.

Operations 2

POST /proposal/linked-request Include a linked proposal
GET /onboarding-proposal Busca uma proposta ou uma lista de propostas.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/celcoin-proposal-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

celcoin-proposal-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: billissuance-settlement-webservice AnnotationCompetenceCalendar Proposal API
  version: v1.0.0
servers:
- url: https://sandbox.openfinance.celcoin.dev/billissuance/v1
tags:
- name: Proposal
paths:
  /proposal/linked-request:
    post:
      tags:
      - Proposal
      summary: Include a linked proposal
      parameters:
      - name: correspAgentId
        in: header
        description: Bank Correspondent Agent Id
        schema:
          type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProposalLinkedRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/ProposalLinkedRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/ProposalLinkedRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProposalLinkedResponse'
        '202':
          description: Accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProposalLinkedResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /onboarding-proposal:
    get:
      tags:
      - Proposal
      summary: Busca uma proposta ou uma lista de propostas.
      parameters:
      - name: ProposalId
        in: query
        description: Id da proposta a ser buscada.
        schema:
          type: string
          example: 3257b215-bef9-402b-a779-104441b520b4
        example: 3257b215-bef9-402b-a779-104441b520b4
      - name: ClientCode
        in: query
        description: Identificador único do cliente a ser buscado.
        schema:
          type: string
          example: 7817b215-beg3-801a-a779-117771t550h2
        example: 7817b215-beg3-801a-a779-117771t550h2
      - name: DateFrom
        in: query
        description: Data inicial.
        schema:
          type: string
          format: date-time
          example: '2023-11-03T06:30:00-03:00'
        example: '2023-11-03T06:30:00-03:00'
      - name: DateTo
        in: query
        description: Data final.
        schema:
          type: string
          format: date-time
          example: '2023-11-03T06:30:00-03:00'
        example: '2023-11-03T06:30:00-03:00'
      - name: Status
        in: query
        description: 'Status da proposta:

          - CREATED

          - PENDING

          - PENDING_DOCUMENTSCOPY

          - APPROVED

          - REPROVED

          - RESOURCE_ERROR

          - RESOURCE_CREATED

          - PROCESSING_DOCUMENTSCOPY'
        schema:
          type: string
          example: PENDING
        example: PENDING
      - name: DocumentNumber
        in: query
        description: Documento da proposta.
        schema:
          maxLength: 14
          minLength: 11
          type: string
          example: '12345678909'
        example: '12345678909'
      - name: Page
        in: query
        description: 'Pagina de solicitaçao, default: 1.'
        schema:
          type: integer
          format: int32
          default: 1
      - name: Limit
        in: query
        description: Limite geral da consulta.
        schema:
          maximum: 200
          minimum: 1
          type: integer
          format: int32
          default: 200
      - name: LimitPerPage
        in: query
        description: Total de propostas por pagina.
        schema:
          maximum: 200
          minimum: 1
          type: integer
          format: int32
          default: 200
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchProposalResponseSuccessResponse'
        '400':
          description: Error handled by the application
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
        '401':
          description: Access Denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
        '500':
          description: Unknown error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
components:
  schemas:
    Contact:
      required:
      - contactValue
      type: object
      properties:
        contactType:
          $ref: '#/components/schemas/ProposalContact'
        contactValue:
          type:
          - string
          - 'null'
      additionalProperties: false
    DocumentscopyResponse:
      type: object
      properties:
        proposalId:
          type:
          - string
          - 'null'
          description: Identificador da proposta.
          example: 12334dfb-4c4e-43fb-ad93-fa28e3123473
        documentNumber:
          type:
          - string
          - 'null'
          description: CPF ou CNPJ da pessoa que teve o(s) documento(s) analisado(s).
        documentscopyId:
          type:
          - string
          - 'null'
          description: Identificador único da documentoscopia.
          example: 12a1e9a958fab500088a8901
        status:
          type:
          - string
          - 'null'
          description: 'Status da documentoscopia:

            - CREATED

            - PENDING

            - APPROVED

            - REPROVED

            - PROCESSING'
          example: APPROVED
        url:
          type:
          - string
          - 'null'
          description: URL utilizada para o usuário encaminhar os seus documentos.
        createdAt:
          type: string
          description: Data de criação da documentoscopia.
          format: date-time
        updateAt:
          type:
          - string
          - 'null'
          description: Data de atualização da documentoscopia.
          format: date-time
      additionalProperties: false
      description: Documentoscopia(s) retornada(s).
    ResponseError:
      required:
      - errorCode
      - message
      type: object
      properties:
        errorCode:
          minLength: 1
          type: string
          description: Código de erro gerado pela Celcoin.
          example: OIE999
        message:
          minLength: 1
          type: string
          description: Mensagem de erro.
          example: Ocorreu um erro interno durante a chamada da api..
      additionalProperties: false
    RejectedReasonResponse:
      type: object
      properties:
        errorCode:
          type:
          - string
          - 'null'
          description: Código de erro referente à rejeição da proposta.
        message:
          type:
          - string
          - 'null'
          description: Motivo da rejeição da proposta.
      additionalProperties: false
      description: Motivo pelo qual a proposta foi rejeitada.
    ErrorResponse:
      type: object
      properties:
        correlationId:
          type:
          - string
          - 'null'
        status:
          type:
          - string
          - 'null'
        errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/Errs'
      additionalProperties: false
    ErrorResponse_2:
      type: object
      properties:
        version:
          type:
          - string
          - 'null'
          description: Versão da api.
          example: 1.0.0
        status:
          type:
          - string
          - 'null'
          description: Status da solicitação.
          example: SUCCESS
        error:
          $ref: '#/components/schemas/ResponseError'
      additionalProperties: false
    Errs:
      type: object
      properties:
        code:
          type:
          - string
          - 'null'
        message:
          type:
          - string
          - 'null'
      additionalProperties: false
    SearchProposalResponse:
      type: object
      properties:
        limit:
          type: integer
          description: Total de propostas.
          format: int32
        currentPage:
          type: integer
          description: Página atual.
          format: int32
        limitPerPage:
          type: integer
          description: Total de propostas por página.
          format: int32
        totalPages:
          type: integer
          description: Total de páginas retornadas.
          format: int32
        totalItems:
          type: integer
          description: Total de propostas retornadas.
          format: int32
        proposal:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ProposalResponse'
      additionalProperties: false
    ProposalResponse:
      type: object
      properties:
        proposalId:
          type:
          - string
          - 'null'
          description: Identificador da proposta.
          example: 12334dfb-4c4e-43fb-ad93-fa28e3123473
        clientCode:
          type:
          - string
          - 'null'
          description: Identificador único fornecido pelo cliente.
          example: 1234ab7c-2855-436b-9d19-8abcdc198e984
        documentNumber:
          type:
          - string
          - 'null'
          description: CPF ou CNPJ da proposta.
        status:
          type:
          - string
          - 'null'
          description: 'Status da proposta:

            - CREATED

            - PENDING

            - PENDING_DOCUMENTSCOPY

            - APPROVED

            - REPPROVED

            - RESOURCE_CREATED

            - RESOURCE_ERROR

            - PROCESSING_DOCUMENTSCOPY'
        proposalType:
          type:
          - string
          - 'null'
          description: 'Tipo da proposta:

            - PF

            - PJ'
          example: PF
        createdAt:
          type:
          - string
          - 'null'
          description: Data de criação da proposta.
          format: date-time
        updatedAt:
          type:
          - string
          - 'null'
          description: Data de atualização da proposta.
          format: date-time
        rejectedReason:
          $ref: '#/components/schemas/RejectedReasonResponse'
        documentscopys:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/DocumentscopyResponse'
      additionalProperties: false
      description: Proposta(s) retornada(s).
    ProposalLinkedResponse:
      type: object
      properties:
        proposalId:
          type:
          - string
          - 'null'
          format: uuid
        proposalNumber:
          type:
          - string
          - 'null'
        balanceCheckId:
          type:
          - string
          - 'null'
          format: uuid
        proposalValidity:
          type:
          - string
          - 'null'
          format: date-time
      additionalProperties: false
    ProposalContact:
      enum:
      - URL
      - WHATSAPP
      - PHONE
      - EMAIL
      - OTHER
      type: string
    ProposalLinkedRequest:
      type: object
      properties:
        id:
          type: string
          format: uuid
        proposalNumber:
          type:
          - string
          - 'null'
        proposalValidity:
          type: string
          format: date-time
        installmentQuantity:
          type: integer
          format: int32
        installmentAmount:
          type: number
          format: double
        availableBalance:
          type: number
          format: double
        amount:
          type: number
          format: double
        iof:
          type: number
          format: double
        anualTax:
          type: number
          format: double
        cet:
          type: number
          format: double
        interestTax:
          type: number
          format: double
        monthlyCet:
          type: number
          format: double
        contacts:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/Contact'
      additionalProperties: false
    SearchProposalResponseSuccessResponse:
      type: object
      properties:
        version:
          type:
          - string
          - 'null'
          description: Versão da api.
          example: 1.0.0
        status:
          type:
          - string
          - 'null'
          description: Status da solicitação.
          example: SUCCESS
        body:
          $ref: '#/components/schemas/SearchProposalResponse'
      additionalProperties: false
  securitySchemes:
    Bearer:
      type: http
      description: Autenticação utilizando JTW Bearer Token
      scheme: Bearer
      bearerFormat: JWT