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

# Post invoicesmatch receipts



## OpenAPI

````yaml /openapi.json post /invoices/match-receipts
openapi: 3.1.1
info:
  title: Anima API
  version: 0.1.0
  description: >-
    The Anima API provides programmatic access to unified infrastructure for AI
    agents: create and manage agents; send and receive email; place phone calls
    and send/receive SMS and voice; store and retrieve vault credentials; manage
    agent identity; and configure webhooks for real-time events. Authenticate
    using a Bearer token or an API key passed via the X-API-Key header.
  contact:
    name: Anima Labs
    url: https://useanima.sh
    email: support@useanima.sh
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://api.useanima.sh/v1
    description: Production
security:
  - BearerAuth: []
  - ApiKeyAuth: []
tags:
  - name: Agents
    description: Create and manage AI agents with email and phone capabilities
  - name: Inboxes
    description: Manage email inboxes and their configurations
  - name: Messages
    description: Send, receive, and search email messages
  - name: Webhooks
    description: Register and manage webhook subscriptions for real-time events
  - name: Organizations
    description: Manage organizations and team settings
  - name: Domains
    description: Configure and verify custom email domains
  - name: Phone
    description: Manage phone numbers and SMS/voice capabilities
  - name: Invoices
    description: Track invoices, match receipts, and reconcile payments
  - name: Billing
    description: View usage, tiers, and billing information
  - name: Security
    description: Configure security policies and access controls
  - name: Vault
    description: Store and retrieve encrypted secrets
  - name: API Keys
    description: Create and manage API keys for programmatic access
paths:
  /invoices/match-receipts:
    post:
      operationId: invoice.matchReceipt
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                receipts:
                  type: array
                  items:
                    type: object
                    properties:
                      receiptId:
                        type: string
                        description: Unique identifier of the receipt.
                      amountCents:
                        anyOf:
                          - type: integer
                          - type: 'null'
                        description: Receipt total in cents, or null if unavailable.
                      currency:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: ISO 4217 currency code, or null if unavailable.
                      merchant:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: >-
                          Merchant name from the receipt, or null if
                          unavailable.
                      orderId:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: Order ID printed on the receipt, or null if absent.
                      confirmationNumber:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: Confirmation or reference number, or null if absent.
                      capturedAt:
                        type: string
                        format: date-time
                        description: ISO 8601 timestamp when the receipt was captured.
                      transactionId:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: Associated payment transaction ID, or null if unknown.
                    required:
                      - receiptId
                      - amountCents
                      - currency
                      - merchant
                      - orderId
                      - confirmationNumber
                      - capturedAt
                      - transactionId
                    description: Receipt data to match against invoices.
                  description: Array of receipts to evaluate for matching.
                invoiceIds:
                  type: array
                  items:
                    type: string
                  description: >-
                    Optional subset of invoice IDs to match against; omit to
                    match against all open invoices.
              required:
                - receipts
              description: Input for bulk receipt-to-invoice matching.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  matches:
                    type: array
                    items:
                      type: object
                      properties:
                        receiptId:
                          type: string
                          description: Unique identifier of the matched receipt.
                        invoiceId:
                          type: string
                          description: Unique identifier of the matched invoice.
                        confidence:
                          type: number
                          description: Overall match confidence score, from 0 to 1.
                        signals:
                          type: array
                          items:
                            type: object
                            properties:
                              field:
                                enum:
                                  - amount
                                  - time
                                  - vendor
                                  - orderId
                                type: string
                                description: The receipt field evaluated for matching.
                              score:
                                type: number
                                description: Confidence score for this signal, from 0 to 1.
                              matched:
                                type: boolean
                                description: >-
                                  Whether this signal indicates a positive
                                  match.
                              detail:
                                type: string
                                description: >-
                                  Human-readable explanation of the match
                                  evaluation.
                            required:
                              - field
                              - score
                              - matched
                              - detail
                            description: >-
                              Individual matching signal used to evaluate
                              receipt-to-invoice correspondence.
                          description: >-
                            Individual signals contributing to the match
                            evaluation.
                        autoLinked:
                          type: boolean
                          description: >-
                            Whether the receipt was automatically linked without
                            manual review.
                      required:
                        - receiptId
                        - invoiceId
                        - confidence
                        - signals
                        - autoLinked
                      description: Result of matching a receipt against an invoice.
                    description: >-
                      Receipts that matched an invoice above the confidence
                      threshold.
                  exceptions:
                    type: array
                    items:
                      type: object
                      properties:
                        receiptId:
                          type: string
                          description: Unique identifier of the matched receipt.
                        invoiceId:
                          type: string
                          description: Unique identifier of the matched invoice.
                        confidence:
                          type: number
                          description: Overall match confidence score, from 0 to 1.
                        signals:
                          type: array
                          items:
                            type: object
                            properties:
                              field:
                                enum:
                                  - amount
                                  - time
                                  - vendor
                                  - orderId
                                type: string
                                description: The receipt field evaluated for matching.
                              score:
                                type: number
                                description: Confidence score for this signal, from 0 to 1.
                              matched:
                                type: boolean
                                description: >-
                                  Whether this signal indicates a positive
                                  match.
                              detail:
                                type: string
                                description: >-
                                  Human-readable explanation of the match
                                  evaluation.
                            required:
                              - field
                              - score
                              - matched
                              - detail
                            description: >-
                              Individual matching signal used to evaluate
                              receipt-to-invoice correspondence.
                          description: >-
                            Individual signals contributing to the match
                            evaluation.
                        autoLinked:
                          type: boolean
                          description: >-
                            Whether the receipt was automatically linked without
                            manual review.
                      required:
                        - receiptId
                        - invoiceId
                        - confidence
                        - signals
                        - autoLinked
                      description: Result of matching a receipt against an invoice.
                    description: Receipts with ambiguous matches requiring manual review.
                  unmatched:
                    type: array
                    items:
                      type: string
                    description: Receipt IDs that could not be matched to any invoice.
                required:
                  - matches
                  - exceptions
                  - unmatched
                description: Results of receipt-to-invoice matching.
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        JWT Bearer token obtained from authentication. Pass as: Authorization:
        Bearer <token>
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: 'API key for programmatic access. Pass as: X-API-Key: <your-key>'

````