{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Accounts Payable"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"accounts-payable","__idx":0},"children":["Accounts Payable"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Accounts Payable API reads the counterparties"," ","of the business linked to your API Access Token, and the bills it owes them."," ","These endpoints require the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accounts_payable:read"]}," scope and are read-only."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Beta"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Accounts Payable 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":["Use Accounts Payable to read who you pay and what you owe: the same counterparty"," ","and bill records shown in the Rho product. Each counterparty carries the stable id"," ","that bills and payments reference as payee, and each bill carries its due date,"," ","approval and payment state, line items, and attached invoice file."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"list-counterparties","__idx":1},"children":["List counterparties"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/ap/counterparties"]}," returns a paginated list of counterparties."," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}," is a case-insensitive substring match on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["legal_name"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nickname"]},"."," ","Filter by one or more ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," values, sort with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort_by"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order"]},", and keep"," ","every filter unchanged while paginating."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://rhoapi.rho.co/api/v1/ap/counterparties?search=acme&status=active&sort_by=legal_name&order=asc&page_size=20\" \\\n  -H \"Authorization: Bearer $RHO_API_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Values"},"children":["Values"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default"},"children":["Default"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Case-insensitive substring match on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["legal_name"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nickname"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["incomplete"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invited"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["active"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["archived"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["all"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Repeatable. Filters by derived display status."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort_by"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_at"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["legal_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sort field."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["asc"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["desc"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["desc"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sort direction."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page_size"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1-100"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["20"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Counterparties per page."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page_token"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cursor from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page.next_page_token"]},". Omit for the first page."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Follow the cursor as described in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1/pagination"},"children":["Pagination"]}," until"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["next_page_token"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},". Page tokens belong to the API version and the"," ","filters that created them, so restart pagination when migrating from v0 to v1 or"," ","when any filter changes."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"counterparties\": [\n    {\n      \"id\": \"3f2b1a44-9c1e-4a8b-bb0e-8b7c2d5e1a90\",\n      \"legal_name\": \"Acme Supplies LLC\",\n      \"nickname\": \"Acme\",\n      \"email\": \"ap@acmesupplies.com\",\n      \"phone_number\": \"+12125550123\",\n      \"registration_country_code\": \"US\",\n      \"memo\": \"Preferred office supplier\",\n      \"status\": \"active\",\n      \"is_business\": true,\n      \"w9_status\": \"complete\",\n      \"address\": {\n        \"street\": \"123 Market St\",\n        \"second_line\": \"Suite 400\",\n        \"city\": \"New York\",\n        \"subdivision\": \"NY\",\n        \"postal_code\": \"10001\",\n        \"country_code\": \"US\"\n      },\n      \"payment_methods\": [\n        {\n          \"id\": \"6d083d95-6e5f-4ec3-b125-6eb41cddc63f\",\n          \"type\": \"ach\",\n          \"is_default\": true,\n          \"description\": \"Checking ending in 1234\",\n          \"bank_name\": \"Example Bank\",\n          \"currency\": \"USD\",\n          \"country_code\": \"US\"\n        },\n        {\n          \"id\": null,\n          \"type\": \"single_use_card\",\n          \"is_default\": false,\n          \"description\": \"Single-use virtual card\",\n          \"currency\": \"USD\",\n          \"country_code\": \"US\"\n        }\n      ],\n      \"created_at\": \"2026-07-01T14:32:07Z\",\n      \"updated_at\": \"2026-07-20T09:15:42Z\"\n    }\n  ],\n  \"page\": {\n    \"next_page_token\": null\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fields that are not on file are omitted from the response rather than returned"," ","as empty strings - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nickname"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone_number"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["registration_country_code"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["memo"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["w9_status"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," are all"," ","optional."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-a-counterparty","__idx":2},"children":["Get a counterparty"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/ap/counterparties/{counterparty_id}"]}," returns one counterparty by its stable id,"," ","in the same shape as a list entry. A counterparty that does not belong to your"," ","business returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404 Not Found"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://rhoapi.rho.co/api/v1/ap/counterparties/3f2b1a44-9c1e-4a8b-bb0e-8b7c2d5e1a90\" \\\n  -H \"Authorization: Bearer $RHO_API_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"status","__idx":3},"children":["Status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," is derived for display and collapses several underlying states:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["incomplete"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A draft missing something needed to pay it - business type, legal name, or a default payment method - or one that failed validation."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invited"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A draft with an unexpired portal invite outstanding, waiting on the counterparty to complete their own details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["active"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ready to be paid."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["archived"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Archived in the Rho product and no longer offered as a payee."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Archived counterparties are returned like any other, so filter on"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status=incomplete&status=invited&status=active"]}," to exclude them, or"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status=archived"]}," to read only them. They stay readable because bills and"," ","payments keep referencing a counterparty after it is archived."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"w-9-status","__idx":4},"children":["W-9 status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["w9_status"]}," is absent when there is no W-9 on file. When present:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complete"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A W-9 was collected through Rho."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complete_externally"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A W-9 exists but was collected outside Rho."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sent_pending"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A W-9 request was sent and is awaiting the counterparty."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payment-methods","__idx":5},"children":["Payment methods"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_methods"]}," lists the non-archived payment methods on file, in the order"," ","Rho displays them: domestic (ACH or wire), international, check, vendor cards,"," ","then a single-use card. At most one is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_default"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ach"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Domestic ACH. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USD"]},"; no ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["wire"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Domestic wire. Carries the beneficiary ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," when on file."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["check"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," is the check shipping address."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["international"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bank_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country_code"]}," come from the beneficiary bank."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vendor_card"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A card issued to this counterparty."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["single_use_card"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available when the counterparty has an email on file. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," on a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["single_use_card"]}," entry. A single-use card is minted per"," ","payment rather than kept on file, so there is no stored record for an id to"," ","name. Every other type carries one. The key is always present, so a null ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," ","means this type has none rather than that the value went missing. Key off ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," ","to tell the entries apart, and expect a null wherever you read"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_methods[].id"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only non-sensitive payment method metadata is exposed. Bank account and routing"," ","numbers are not returned under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accounts_payable:read"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"counterparty-notes-and-limitations","__idx":6},"children":["Counterparty notes and limitations"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_business"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," when the counterparty's type is not yet known, which"," ","happens on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["incomplete"]}," counterparties. It does not confirm the counterparty"," ","is an individual."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Archived payment methods are omitted, and only the first check detail is"," ","returned when a counterparty has more than one."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Counterparties are returned as standalone payees. Related bills are not"," ","embedded."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["These endpoints are read-only. Creating, editing, inviting, and archiving"," ","counterparties are not available."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"list-bills","__idx":7},"children":["List bills"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/ap/bills"]}," returns a paginated list of bills. Search matches payee"," ","name and email, creator name, invoice number, and amount."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://rhoapi.rho.co/api/v1/ap/bills?status=scheduled&sort_by=due_date&order=asc&page_size=20\" \\\n  -H \"Authorization: Bearer $RHO_API_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Free-text match across payee name and email, creator name, invoice number, and amount."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BillStatus[]"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Repeat the parameter to filter on several statuses."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["due_date_after"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Earliest due date to include, inclusive."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["due_date_before"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Latest due date to include, inclusive."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_after"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date-time"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Earliest creation time to include, inclusive."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_before"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date-time"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Latest creation time to include, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["exclusive"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort_by"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enum"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_at"]}," (default), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["due_date"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enum"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["asc"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["desc"]},", defaults to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["desc"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page_size"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["integer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 to 100, defaults to 20."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page_token"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cursor from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page.next_page_token"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Follow the cursor as described in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1/pagination"},"children":["Pagination"]}," until"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["next_page_token"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},", and keep filters and sorting unchanged while"," ","paginating. Page tokens belong to the API version and the filters that"," ","created them, so restart pagination when migrating from v0 to v1."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"bills\": [\n    {\n      \"id\": \"3f2b1a44-9c1e-4a8b-bb0e-8b7c2d5e1a90\",\n      \"status\": \"scheduled\",\n      \"amount\": {\"amount\": 120050, \"currency\": \"USD\"},\n      \"counterparty\": {\"id\": \"7a1c0b22-8d33-4dd9-9d5d-b3171c4c3d71\"},\n      \"invoice_number\": \"BILL-2026-0042\",\n      \"invoice_date\": \"2026-07-24\",\n      \"due_date\": \"2026-08-01\",\n      \"lines\": [\n        {\n          \"id\": \"f6b24a27-4a89-4a89-ae0b-4f4212dd5a15\",\n          \"index\": 1,\n          \"amount\": {\"amount\": 100000, \"currency\": \"USD\"},\n          \"description\": \"Consulting Services - July\",\n          \"created_by_user_id\": \"a8d32021-5c7d-45f8-8be7-65e9d48db4ec\",\n          \"created_at\": \"2026-07-01T14:32:07Z\",\n          \"updated_at\": \"2026-07-20T09:15:42Z\"\n        }\n      ],\n      \"file_id\": \"d8593b96-f0f4-4d36-8a5c-7d7d7b9f910a\",\n      \"transaction\": {\"id\": \"6ef5df3b-50d5-4d7b-9877-dcf8127f1a8d\"},\n      \"payment_date\": \"2026-08-01\",\n      \"memo\": \"Net 30 terms apply.\",\n      \"created_at\": \"2026-07-01T14:32:07Z\",\n      \"updated_at\": \"2026-07-20T09:15:42Z\"\n    }\n  ],\n  \"page\": {\n    \"next_page_token\": null\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amounts use the currency's smallest unit (cents for USD), so ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["120050"]}," is"," ","$1,200.50. When a bill is itemized, its line amounts sum to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]},"; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lines"]}," is"," ","empty otherwise. A bill that has no amount set yet - a draft still being filled"," ","in, for instance - leaves ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}," out of the response entirely, so read it as"," ","optional rather than defaulting to zero."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["counterparty"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction"]}," carry only an identifier. Read the full"," ","counterparty record from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/ap/counterparties/{counterparty_id}"]},", and the settled"," ","payment from the transactions endpoints."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"bill-status","__idx":8},"children":["Bill status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," folds bill state, approval stage, and payment state into one value."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["draft"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not yet submitted for payment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["missing_payment_details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submitted, but blocked until the payment details it needs are on file."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["awaiting_approval"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pending one or more approvals."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ready_for_payment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Approved and payable, not yet scheduled."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scheduled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment scheduled for a future date."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending_payment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment in flight, not yet settled."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment settled."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed_payment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment failed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["archived"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The bill or its payment was archived."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["other"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A state that does not map to any value above."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The table is roughly in lifecycle order, but a bill does not necessarily pass"," ","through every state and the order is not guaranteed - don't infer progress from"," ","it. Treat ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["other"]}," as a catch-all rather than a stable state: new states surface"," ","there before they get their own value."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scheduled"]}," does not guarantee a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_date"]},". A bill can be scheduled"," ","upstream before a date is attached, so read the two independently."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-a-bill","__idx":9},"children":["Get a bill"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/ap/bills/{bill_id}"]}," returns one bill by ID. A bill belonging to another"," ","business responds ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]},", the same as one that does not exist."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://rhoapi.rho.co/api/v1/ap/bills/3f2b1a44-9c1e-4a8b-bb0e-8b7c2d5e1a90\" \\\n  -H \"Authorization: Bearer $RHO_API_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"download-a-bill-file","__idx":10},"children":["Download a bill file"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/ap/bills/{bill_id}/files/{file_id}"]}," returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file_name"]},", and"," ","a fresh short-lived signed ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["download_url"]},". ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file_id"]}," must match ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bill.file_id"]}," ","from list/get when that field is set. Fetch again whenever you need a new signed"," ","URL; do not persist the URL."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://rhoapi.rho.co/api/v1/ap/bills/3f2b1a44-9c1e-4a8b-bb0e-8b7c2d5e1a90/files/d8593b96-f0f4-4d36-8a5c-7d7d7b9f910a\" \\\n  -H \"Authorization: Bearer $RHO_API_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"file_id\": \"d8593b96-f0f4-4d36-8a5c-7d7d7b9f910a\",\n  \"file_name\": \"BILL-2026-0042.pdf\",\n  \"download_url\": \"https://files.example/bill.pdf?signature=...\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reference","__idx":11},"children":["Reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Full endpoint catalogue - paths, parameters, response shapes, and required"," ","scopes - lives in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v1/openapi/accounts-payable"},"children":["API Reference"]},"."]}]},"headings":[{"value":"Accounts Payable","id":"accounts-payable","depth":1},{"value":"List counterparties","id":"list-counterparties","depth":2},{"value":"Get a counterparty","id":"get-a-counterparty","depth":2},{"value":"Status","id":"status","depth":2},{"value":"W-9 status","id":"w-9-status","depth":2},{"value":"Payment methods","id":"payment-methods","depth":2},{"value":"Counterparty notes and limitations","id":"counterparty-notes-and-limitations","depth":2},{"value":"List bills","id":"list-bills","depth":2},{"value":"Bill status","id":"bill-status","depth":3},{"value":"Get a bill","id":"get-a-bill","depth":2},{"value":"Download a bill file","id":"download-a-bill-file","depth":2},{"value":"Reference","id":"reference","depth":2}],"frontmatter":{"seo":{"title":"Accounts Payable"}},"lastModified":"2026-10-20T10:46:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/v1/accounts-payable","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}