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

# One SPB send and its query history

> The latest send of the control identifier in the caller tenant's journal. 404 JDC-0302 when the journal does not hold it.



## OpenAPI

````yaml /en/openapi/v3-current/jd-courier.yaml get /v1/send-journal/{controlId}
openapi: 3.1.0
info:
  description: >-
    The JD Courier API. Operators use it to manage the engines, the ownership
    map, the delivery modes and bypass of each rail, the retained messages, the
    SPB send journal and reconciliation. Engines use it to resolve the owner of
    a key, claim their Pix Automático recurrences and declare their Pix
    Automático payment legs.
  title: JD Courier API
  version: v1.0.0
servers: []
security:
  - BearerAuth: []
tags:
  - description: >-
      The engine registry: the cores that consume the JD channel through the
      Courier, each with its participant set
    name: Engines
  - description: 'The ownership map: which engine owns each key. Every change is audited.'
    name: ownership
  - description: >-
      The rails: what each declares about itself, its state per tenant, and the
      bypass declaration
    name: channels
  - description: >-
      The engines' side of the ownership map: resolution for the on-us gate,
      authoritative and never advisory, the claim of a Pix Automático recurrence
      the engine holds, and the declaration of a payment leg it holds.
    name: ownership-query
  - description: >-
      The durable message store: redelivery on demand, without asking the vendor
      again
    name: ledger
  - description: >-
      Count reconciliation per rail: E(m) = C(m) + T(m) + R(m), the sequence
      gaps it saw, and the sends whose return leg never arrived
    name: assurance
  - description: >-
      The SPB send journal: every send, written before it leaves, and the sends
      whose outcome is unknown. A by-hand close records an operator's finding
      and never resends.
    name: send-journal
  - description: >-
      Per-(tenant, channel) state an operator acts on: lifting a durable channel
      halt
    name: channel-leases
  - description: >-
      Messages the Courier holds because no engine could receive them. A routing
      or delivery retention leaves by itself once its cause lifts, or when an
      operator asks for its routing decision to be run again.
    name: retained
paths:
  /v1/send-journal/{controlId}:
    get:
      tags:
        - send-journal
      summary: One SPB send and its query history
      description: >-
        The latest send of the control identifier in the caller tenant's
        journal. 404 JDC-0302 when the journal does not hold it.
      operationId: getSendRecord
      parameters:
        - in: path
          name: controlId
          required: true
          schema:
            maxLength: 256
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SendRecord'
          description: OK
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Bad Request
        '401':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Unauthorized
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Forbidden
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Not Found
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Internal Server Error
        '503':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Service Unavailable
components:
  schemas:
    SendRecord:
      additionalProperties: false
      properties:
        ageSeconds:
          description: >-
            Present while the outcome is INDETERMINATE: seconds since the send
            left, growing, for an open send; frozen at closedAt minus sentAt
            once an operator closed it by hand, because a closed send no longer
            ages for the alert.
          format: int64
          type: integer
        channelId:
          enum:
            - spb
          type: string
        closedByHand:
          description: >-
            An operator's by-hand close; null unless one was recorded. A record
            only: the outcome is unchanged.
          oneOf:
            - $ref: '#/components/schemas/SendHandClose'
            - type: 'null'
        controlId:
          type: string
        engineId:
          description: Originating engine; this field routes the SPB return leg.
          type: string
        outcome:
          enum:
            - DETERMINED
            - INDETERMINATE
            - RESOLVED
            - NOT_SENT
          type: string
        queries:
          description: >-
            The engine's ConsultaNumCtrlIF trail for this send; null until the
            first.
          oneOf:
            - $ref: '#/components/schemas/SendQueryHistory'
            - type: 'null'
        resolution:
          description: >-
            How the vendor's own answer settled an indeterminate send; null
            until it did.
          oneOf:
            - $ref: '#/components/schemas/SendResolution'
            - type: 'null'
        sentAt:
          format: date-time
          type: string
        vendorCode:
          type:
            - string
            - 'null'
        vendorSequence:
          type:
            - string
            - 'null'
      required:
        - controlId
        - engineId
        - channelId
        - sentAt
        - outcome
        - vendorCode
        - vendorSequence
        - resolution
        - queries
        - closedByHand
      type: object
    Detail:
      additionalProperties: true
      properties:
        code:
          description: >-
            Stable, machine-readable domain error code scoped to the emitting
            service (format: <SERVICE>-NNNN).
          type: string
        detail:
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
          examples:
            - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
            - array
            - 'null'
        instance:
          description: >-
            A URI reference that identifies the specific occurrence of the
            problem.
          examples:
            - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
            - 400
          format: int64
          type: integer
        title:
          description: >-
            A short, human-readable summary of the problem type. This value
            should not change between occurrences of the error.
          examples:
            - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
            - https://example.com/errors/example
          format: uri
          type: string
        upstream:
          $ref: '#/components/schemas/Upstream'
          description: >-
            RFC 9457 extension member: the error a proxied third-party provider
            reported. Absent unless the emitting service explicitly surfaced
            one.
      type: object
    SendHandClose:
      additionalProperties: false
      properties:
        closedAt:
          format: date-time
          type: string
        closedBy:
          type: string
        evidenceReference:
          type: string
        note:
          type: string
      required:
        - closedAt
        - closedBy
        - evidenceReference
        - note
      type: object
    SendQueryHistory:
      additionalProperties: false
      properties:
        count:
          format: int64
          minimum: 1
          type: integer
        lastAnswer:
          description: >-
            VENDOR: forwarded, answered by JD. LOCAL_ALN01: the send never left,
            answered by the Courier.
          enum:
            - VENDOR
            - LOCAL_ALN01
          type: string
        lastQueriedAt:
          format: date-time
          type: string
      required:
        - count
        - lastQueriedAt
        - lastAnswer
      type: object
    SendResolution:
      additionalProperties: false
      properties:
        actualOutcome:
          enum:
            - REACHED_VENDOR
            - DID_NOT_REACH_VENDOR
          type: string
        means:
          type: string
        note:
          type: string
        resolvedAt:
          format: date-time
          type: string
        resolvedBy:
          type: string
      required:
        - resolvedAt
        - means
        - actualOutcome
        - resolvedBy
        - note
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
    Upstream:
      additionalProperties: false
      properties:
        code:
          description: The upstream provider's own error code, verbatim.
          examples:
            - E4001
          type: string
        message:
          description: >-
            The upstream provider's own error message, verbatim (bounded, never
            its raw response body).
          examples:
            - account not found at provider
          type: string
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      description: JWT bearer token issued by the identity provider.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.