Reimbursements API Overview — Proposed Guide

Reimbursements API Overview: A reimbursement record would connect an approved business expense to an intended repayment process. Recording that…

Overview

A reimbursement record would connect an approved business expense to an intended repayment process. Recording that relationship is not the same as initiating or completing a payment.

Key concepts

Separate review eligibility, reimbursement state and provider settlement state. Retain the source expense references.

Implementation considerations

Every payment-related example is conceptual. No payment rail, bank connection or money movement is configured by this documentation.

Proposed API behavior

GET /v1/reimbursements is an illustrative design for this topic. Path and field names may change before implementation. Access would require an authorized organization context and operation-specific permission; no public API or authorization grant is available here.

Static example requests

# Proposed request text only; this reserved host is not a live API.
curl -X GET 'https://api.remizen.example/v1/reimbursements?status=draft' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Fictional response example

{
  "data": [
    {
      "reimbursement_id": "reimb_example_123",
      "expense_id": "exp_example_123",
      "amount_minor": 12550,
      "currency": "USD",
      "id": "reimb_example_123",
      "organization_id": "org_example_123",
      "expense_ids": [
        "exp_example_123"
      ],
      "status": "draft"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "request_id": "req_example_123",
    "reference_only": true
  }
}

Illustrative error case

Review this failure case in context: Every payment-related example is conceptual. No payment rail, bank connection or money movement is configured by this documentation.

{
  "error": {
    "code": "validation_error",
    "message": "The proposed reimbursements api overview operation requires review of its input or authorization.",
    "request_id": "req_example_123"
  }
}

Proposed data types

Related documentation