Care MCP

POST /api/pro/payouts

Invoices us for everything owed. The earnings move onto the payout; nothing owed answers that nothing is. An employee is answered 403.

Surface: professional. Who may call: professional. Key: professional.payouts.request.

Example request

curl -X POST https://caremcp.com/api/pro/payouts \
  -H "Authorization: Bearer <session or access token>" \
  -H "Content-Type: application/json" \
  -d '{"invoiceNumber":"VERA-2026-014"}'

Example input

{
  "invoiceNumber": "VERA-2026-014"
}

Input schema

{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "invoiceNumber": {
   "type": "string",
   "minLength": 1,
   "maxLength": 60,
   "description": "The professional's own invoice number."
  }
 },
 "required": [
  "invoiceNumber"
 ]
}

Output schema

{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "id": {
   "type": "string"
  },
  "amountCents": {
   "type": "integer",
   "minimum": -9007199254740991,
   "maximum": 9007199254740991
  },
  "invoiceNumber": {
   "type": "string"
  },
  "status": {
   "type": "string",
   "enum": [
    "invoiced",
    "paid"
   ]
  },
  "at": {
   "type": "string"
  },
  "paidAt": {
   "type": [
    "string",
    "null"
   ]
  },
  "earnings": {
   "type": "integer",
   "minimum": -9007199254740991,
   "maximum": 9007199254740991
  }
 },
 "required": [
  "id",
  "amountCents",
  "invoiceNumber",
  "status",
  "at",
  "paidAt",
  "earnings"
 ],
 "additionalProperties": false
}