{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Reimbursements"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"reimbursements","__idx":0},"children":["Reimbursements"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Beta"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Reimbursements API is in Beta. Additive changes are normal, and breaking changes"," ","may be made with notice while the resource incorporates customer feedback. See"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1/versioning"},"children":["Versioning and compatibility"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These endpoints read reimbursements for the business linked to your API Access"," ","Token. They all require the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reimbursements:read"]}," scope."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"list-reimbursements","__idx":1},"children":["List reimbursements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/reimbursements"]}," returns reimbursements for your business."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://rhoapi.rho.co/api/v1/reimbursements?approval_status=approved&page_size=20\" \\\n  -H \"Authorization: Bearer $RHO_API_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["approval_status"]}," may each be repeated. Repeated values for one"," ","filter are combined as alternatives, and different filters combine together."," ","For example, two ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_id"]}," values and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["approval_status=approved"]}," return approved"," ","reimbursements belonging to either user."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The date filters are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_date_after"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_date_before"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_after"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_before"]},". ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_date"]}," is the UTC calendar"," ","date of the spend. Each ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["after"]}," bound is inclusive and each ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["before"]}," bound is"," ","exclusive. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["has_attachments=true"]}," returns only reimbursements"," ","with at least one attachment; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," returns only those without one. Leaving it"," ","out does not filter by attachments."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort_by"]}," accepts ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_at"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_date"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]},". ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order"]}," accepts"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["asc"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["desc"]},". The default is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_at"]}," descending. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page_size"]}," defaults to"," ","20 and may be from 1 to 100. Follow ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page.next_page_token"]}," as described in"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1/pagination"},"children":["Pagination"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"reimbursements\": [\n    {\n      \"id\": \"60000000-0000-4000-8000-000000000002\",\n      \"amount\": {\"amount\": 9800, \"currency\": \"USD\"},\n      \"original_amount\": {\"amount\": 8400, \"currency\": \"EUR\"},\n      \"merchant_name\": \"Hotel Europa\",\n      \"merchant_category\": \"Lodging\",\n      \"transaction_date\": \"2026-06-18\",\n      \"created_at\": \"2026-06-19T09:00:00Z\",\n      \"type\": \"out_of_pocket\",\n      \"user_id\": \"40000000-0000-4000-8000-000000000002\",\n      \"approval_status\": \"approved\",\n      \"payment_status\": \"paid\",\n      \"note\": \"Conference hotel\",\n      \"attendee_user_ids\": [],\n      \"client\": \"Atlas\",\n      \"fields\": [\n        {\n          \"field_id\": \"field-department\",\n          \"field_name\": \"Department\",\n          \"value\": \"Sales\",\n          \"value_id\": \"option-department-sales\"\n        }\n      ],\n      \"attachments\": [\n        {\n          \"file_id\": \"50000000-0000-4000-8000-000000000001\",\n          \"file_name\": \"hotel-receipt.pdf\",\n          \"automatically_matched\": true,\n          \"attached_at\": \"2026-06-19T09:05:00Z\"\n        }\n      ]\n    }\n  ],\n  \"page\": {\"next_page_token\": null}\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amounts are integer minor units. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["original_amount"]}," is the submitted amount when"," ","the source recorded one separately; it can use the same currency as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}," or"," ","a different currency. Nullable properties remain present in JSON with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," ","when no value was recorded. This includes merchant details, note, client,"," ","an attachment's filename and attachment time, and a custom field's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value_id"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mileage"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["out_of_pocket"]},". Approval status is one of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_ready"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["needs_approval"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["approved"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["automatically_approved"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rejected"]},", or"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["archived"]},". Payment status is one of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["awaiting"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processing"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paid"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marked_as_paid"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unknown"]},"; only payment status uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unknown"]}," ","when the payment state cannot be named."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fields"]}," contains all coding tags returned for the reimbursement, including"," ","custom fields and system-managed tags such as Department and Labels. A selected"," ","option has a stable ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value_id"]},"; a free-text value has ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value_id: null"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-a-reimbursement","__idx":2},"children":["Get a reimbursement"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/reimbursements/{reimbursement_id}"]}," returns one reimbursement with"," ","the same fields as the list."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://rhoapi.rho.co/api/v1/reimbursements/60000000-0000-4000-8000-000000000002\" \\\n  -H \"Authorization: Bearer $RHO_API_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"download-an-attachment","__idx":3},"children":["Download an attachment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/reimbursements/{reimbursement_id}/files/{file_id}"]}," returns file"," ","metadata and a fresh signed download URL. The file and reimbursement must both"," ","belong to your business, and the file must be attached to that reimbursement."," ","Follow the returned URL without an Authorization header and do not store it."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://rhoapi.rho.co/api/v1/reimbursements/60000000-0000-4000-8000-000000000002/files/50000000-0000-4000-8000-000000000001\" \\\n  -H \"Authorization: Bearer $RHO_API_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reference","__idx":4},"children":["Reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v1/openapi/reimbursements"},"children":["Rho API v1 reference"]}," for all fields and"," ","parameters."]}]},"headings":[{"value":"Reimbursements","id":"reimbursements","depth":1},{"value":"List reimbursements","id":"list-reimbursements","depth":2},{"value":"Get a reimbursement","id":"get-a-reimbursement","depth":2},{"value":"Download an attachment","id":"download-an-attachment","depth":2},{"value":"Reference","id":"reference","depth":2}],"frontmatter":{"seo":{"title":"Reimbursements"}},"lastModified":"2026-10-23T10:00:23.883Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/v1/reimbursements","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}