How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Float Public API

REST API (OpenAPI 3.1.0, 71 operations across 47 paths) for automating accounting and reporting against Float. Read card transactions, account transactions, bills, bill attachments, payments, reimbursements and receipts; manage the coding dimensions (GL codes, tax codes, tax components, custom fields, vendors, subsidiaries); read cards, card limits, teams, users, approval and submission policies; create and manage API accounting connections and webhook subscriptions. Bearer-token auth with per-business API tokens issued from the Float web app. Cursor-free page/page_size pagination with created_at range filters.

This API exposes 71 operations across 47 paths, organized into 23 resource areas, and defines 180 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://api.floatfinancial.com.

71 operations 47 paths 180 schemas 5 DELETE42 GET12 PATCH12 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.floatfinancial.com
Authentication
HTTP Bearer
Resource Areas
23

Authentication & Security 1

Float Public API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerToken).

Paths & Operations 71

Across 47 paths, the API surfaces 71 operations — 5 DELETE, 42 GET, 12 PATCH, 12 POST. They span 23 resource areas, including Account Transactions, Accounting Connections, Accounts, Approval Policies, Bills, Bill Attachments, Card Limits, Card Transactions, and 15 more. Each is listed below with its method, path, parameters, and response codes.

Account Transactions 2
GET
/v1/account-transactions
Retrieve a paginated list of account transactions
getAccountTransactions 8 params → 200
GET
/v1/account-transactions/{transaction_id}
Retrieve a single account transaction by transaction ID
getAccountTransactionByTransactionId 1 param → 200404
Accounting Connections 4
GET
/v1/accounting-connections
Retrieve all accounting connections for the business
getAccountingConnections → 200
POST
/v1/accounting-connections
Create a new API accounting connection
createAccountingConnection 1 param body → 201400
PATCH
/v1/accounting-connections/{connection_id}
Update an accounting connection
updateAccountingConnection 1 param body → 200404
DELETE
/v1/accounting-connections/{connection_id}
Delete an accounting connection
deleteAccountingConnection 1 param → 204404
Accounts 2
GET
/v1/accounts
Retrieve a paginated list of accounts
getAccounts 5 params → 200
GET
/v1/accounts/{account_id}
Retrieve a single account by ID
getAccountById 1 param → 200404
Approval Policies 2
GET
/v1/approval-policies
Retrieve a paginated list of approval policies
getApprovalPolicies 5 params → 200
GET
/v1/approval-policies/{approval_policy_id}
Retrieve an approval policy by ID
getApprovalPolicyById 1 param → 200404
Bills 5
GET
/v1/bills
Retrieve a paginated list of bills
getBills 6 params → 200
PATCH
/v1/bills
Update multiple bills
patchBills body → 200404
GET
/v1/bills/{bill_id}
Retrieve a bill by ID
getBillById 1 param → 200404
PATCH
/v1/bills/{bill_id}
Update bill
patchBill 1 param body → 200404
POST
/v1/bills/{bill_id}/sync
Mark a bill as synced
markBillAsSynced 2 params body → 200404
Bill Attachments 2
GET
/v1/bills/{bill_id}/attachments
Retrieve a paginated list of bill attachments by bill ID
getBillAttachments 6 params → 200404
GET
/v1/bills/attachments/{bill_attachment_id}
Retrieve a bill attachment by ID
getBillAttachmentById 1 param → 200404
Card Limits 3
GET
/v1/card-limits
Retrieve a list of all card limits
getCardLimits 6 params → 200
POST
/v1/card-limits
BETA: Create a new card limit
createCardLimit 1 param body → 201422
GET
/v1/card-limits/{card_limit_id}
Retrieve a single card limit by ID
getCardLimitById 1 param → 200404
Card Transactions 4
GET
/v1/card-transactions
Retrieve a list of paginated card transactions
getTransactions 6 params → 200
PATCH
/v1/card-transactions
Update multiple card transactions
patchTransactions body → 200404
GET
/v1/card-transactions/{transaction_id}
Retrieve a single card transaction by ID
getTransactionById 1 param → 200404
PATCH
/v1/card-transactions/{transaction_id}
Update card transaction
patchTransaction 1 param body → 200404
Cards 3
GET
/v1/cards
Retrieve a list of all cards
getCards 5 params → 200
POST
/v1/cards
BETA: Create a new card
createCard 1 param body → 201
GET
/v1/cards/{card_id}
Retrieve a single card by ID
getCardById 1 param → 200404
Custom Fields 9
GET
/v1/custom-fields
Retrieve a paginated list of custom fields
getCustomFields 5 params → 200
POST
/v1/custom-fields
Create custom fields
createCustomFields body → 202400
DELETE
/v1/custom-fields
Delete custom fields
deleteCustomFields → 204400
GET
/v1/custom-fields/{custom_field_id}
Retrieve a custom field by ID
getCustomFieldById 1 param → 200404
PATCH
/v1/custom-fields/{custom_field_id}
Update a custom field
updateCustomField 2 params body → 200400404
DELETE
/v1/custom-fields/{custom_field_id}
Delete a custom field by ID
deleteCustomFieldById 1 param → 204404
POST
/v1/custom-fields/{custom_field_id}/options
Create custom field options
createCustomFieldOptions 1 param body → 202400404
PATCH
/v1/custom-fields/{custom_field_id}/options/{option_id}
Update a custom field option
updateCustomFieldOption 3 params body → 200400404
DELETE
/v1/custom-fields/{custom_field_id}/options/{option_id}
Delete a custom field option by ID
deleteCustomFieldOptionById 2 params → 204404
GL Codes 4
GET
/v1/gl-codes
Retrieve a paginated list of GL Codes
getGLCodes 5 params → 200
POST
/v1/gl-codes
Create GL codes
createGLCodes body → 202
GET
/v1/gl-codes/{gl_code_id}
Retrieve a single GL code by ID
getGLCodeById 1 param → 200404
PATCH
/v1/gl-codes/{gl_code_id}
Update a GL code
updateGLCode 2 params body → 200400404
Meta 1
GET
/v1/openapi
Retrieve the OpenAPI schema for the Float API
getOpenAPI → 200
Payments 2
GET
/v1/payments
Retrieve a paginated list of payments
getPayments 5 params → 200
GET
/v1/payments/{payment_id}
Retrieve a payment by ID
getPaymentById 1 param → 200404
Receipts 2
GET
/v1/receipts
Retrieve a list of all receipts
getReceipts 5 params → 200
GET
/v1/receipts/{receipt_id}
Retrieve a single receipt by ID
getReceiptById 1 param → 200404
Reimbursements 5
GET
/v1/reimbursements
Retrieve a paginated list of reimbursement reports
getReimbursements 6 params → 200
PATCH
/v1/reimbursements
Update multiple reimbursements
patchReimbursements body → 200404
GET
/v1/reimbursements/{reimbursement_id}
Retrieve a reimbursement report
getReimbursement 1 param → 200404
PATCH
/v1/reimbursements/{reimbursement_id}
Update reimbursement
patchReimbursement 1 param body → 200404
POST
/v1/reimbursements/{reimbursement_id}/sync
Mark a reimbursement as synced
markReimbursementAsSynced 2 params body → 200404
Submission Policies 2
GET
/v1/submission-policies
Retrieve a paginated list of submission policies
getSubmissionPolicies 5 params → 200
GET
/v1/submission-policies/{submission_policy_id}
Retrieve a submission policy by ID
getSubmissionPolicyById 1 param → 200404
Subsidiaries 2
GET
/v1/subsidiaries
Retrieve a list of all subsidiaries
getSubsidiaries 5 params → 200403
GET
/v1/subsidiaries/{subsidiary_id}
Retrieve a single subsidiary by ID
getSubsidiaryById 1 param → 200403404
Tax Codes 5
GET
/v1/tax-codes
Retrieve a list of all tax codes
getTaxCodes 5 params → 200
POST
/v1/tax-codes
Create tax codes
createTaxCodes body → 202
GET
/v1/tax-codes/{tax_code_id}
Retrieve a single tax code by ID
getTaxCodeById 1 param → 200404
PATCH
/v1/tax-codes/{tax_code_id}
Update a tax code
updateTaxCode 1 param body → 200400404
DELETE
/v1/tax-codes/{tax_code_id}
Delete a single tax code by ID
deleteTaxCodeById 1 param → 204
Tax Components 1
GET
/v1/tax-components
Retrieve a list of all tax components
tax_components_retrieve 5 params → 200
Teams 2
GET
/v1/teams
Retrieve a paginated list of teams
getTeams 5 params → 200
GET
/v1/teams/{team_id}
Retrieve a team by ID
getTeamById 1 param → 200404
Users 3
GET
/v1/users
Retrieve a paginated list of users
getUsers 5 params → 200
POST
/v1/users
Create a new user
createUser 1 param body → 201400
GET
/v1/users/{user_id}
Retrieve a single user by ID
getUserById 1 param → 200404
Vendors 4
GET
/v1/vendors
Retrieve a list of all vendors
getVendors 5 params → 200
POST
/v1/vendors
Create vendors
createVendors body → 202
GET
/v1/vendors/{vendor_id}
Retrieve a single vendor by ID
getVendorById 1 param → 200404
PATCH
/v1/vendors/{vendor_id}
Update vendor
patchVendor 1 param body → 200404
Webhooks 2
GET
/v1/webhooks
Retrieve a paginated list of webhook subscriptions
getWebhookSubscriptions 5 params → 200
POST
/v1/webhooks
Create a webhook subscription
createWebhookSubscription body → 201400

Schemas 180

The contract defines 180 schemas that model the data the API accepts and returns. The most detailed are CardTransactionSchema (23 properties), ReimbursementReportSchema (20 properties), BillSchema (19 properties), ExpenseSchema (18 properties). Each schema is shown below with its type and property counts.

AbstractAssignee
string
AccountSchema
object
3 properties 3 required
AccountTransactionSchema
object
13 properties 13 required
AccountTransactionType
string
AccountType
string
AccountViewSchema
object
4 properties 4 required
AccountingConnectionCreateSchema
object
1 property 1 required
AccountingConnectionListSchema
object
1 property 1 required
AccountingConnectionSchema
object
5 properties 5 required
AccountingConnectionStatus
string
AccountingConnectionType
string
AccountingReviewStatus
string
AccountingStageEnum
string
INREVIEW - INREVIEW READYTOEXPORT - READYTOEXPORT EXPORTED - EXPORTED
AllowedValuesRuleSchema_AccountingVendor_
object
4 properties 4 required
AllowedValuesRuleSchema_GLCode_
object
4 properties 4 required
AllowedValuesRuleSchema_GenericTag_
object
4 properties 4 required
AllowedValuesRuleSchema_TaxCode_
object
4 properties 4 required
ApprovalLevelSchema
object
2 properties 2 required
ApprovalPolicySchema
object
7 properties 7 required
ApprovalPolicyType
string
ApprovalStateEnum
string
ApprovalStepApproversSchema
object
3 properties 3 required
ApprovalStepSchema
object
2 properties 2 required
ApprovalWorkflowSchema
object
2 properties 2 required
AutoPauseSchema
object
2 properties 2 required
BaseApprovalPolicySchema
object
3 properties 3 required
BatchUpdateResponseSchema
object
2 properties 2 required
BillAttachmentSchema
object
5 properties 5 required
BillLineItemSchema
object
8 properties 8 required
BillPaymentStatus
string
This contains all the same choices from the AccountsPayablePaymentStatus but with the addition of CREATED and MARKEDASPAID
BillSchema
object
19 properties 19 required
BillStatus
string
BillUpdateSchema
object
1 property
CardActivationStateType
string
CardLimitSchema
object
9 properties 9 required
CardLimitStatus
string
CardLimitType
string
CardPausedStateType
string
CardSchema
object
13 properties 11 required
CardTransactionAccountingStageSchema
string
CardTransactionSchema
object
23 properties 15 required
CardTransactionType
string
CardTransactionUpdateSchema
object
3 properties
CountablePagedResponse_AccountViewSchema
object
8 properties 8 required
CountablePagedResponse_ApprovalPolicySchema
object
8 properties 8 required
CountablePagedResponse_BillAttachmentSchema
object
8 properties 8 required
CountablePagedResponse_BillSchema
object
8 properties 8 required
CountablePagedResponse_CardLimitSchema
object
8 properties 8 required
CountablePagedResponse_CardSchema
object
8 properties 8 required
CountablePagedResponse_CardTransactionSchema
object
8 properties 8 required
CountablePagedResponse_GLCodeOutputSchema
object
8 properties 8 required
CountablePagedResponse_ReceiptSchema
object
8 properties 8 required
CountablePagedResponse_ReimbursementReportSchema
object
8 properties 8 required
CountablePagedResponse_SubmissionPolicySchema
object
8 properties 8 required
CountablePagedResponse_SubsidiarySchema
object
8 properties 8 required
CountablePagedResponse_TaxCodeOutputSchema
object
8 properties 8 required
CountablePagedResponse_TaxComponentOutputSchema
object
8 properties 8 required
CountablePagedResponse_TeamSchema
object
8 properties 8 required
CountablePagedResponse_UnionType_MultiSelectSchema_StringSchema
object
8 properties 8 required
CountablePagedResponse_UserSchema
object
8 properties 8 required
CountablePagedResponse_VendorOutputSchema
object
8 properties 8 required
CreateCardLimitForCardSchema
object
7 properties 4 required
CreateCardLimitSchema
object
6 properties 3 required
CreateCardSchema
object
12 properties 4 required
CreateCardSchemaCurrencyEnum
string
CreateWebhookSubscriptionResponseSchema
object
5 properties 5 required
CreateWebhookSubscriptionSchema
object
1 property 1 required
Currencies
string
CustomFieldInputListSchema
object
2 properties 2 required
CustomFieldInputSchema
object
3 properties 2 required
CustomFieldOptionInputListSchema
object
2 properties 2 required
CustomFieldRuleSchema
object
5 properties 5 required
CustomFieldSchema
CustomFieldType
string
EmailPreference
object
1 property 1 required
EmailReferenceSchema_UserSchema_
object
2 properties 2 required
ExpenseReportPaymentStatus
string
ExpenseSchema
object
18 properties 18 required
ExportSchema
object
1 property 1 required
ExportStatus
string
ExternalIdReferenceSchema_GLCodeOutputSchema_
object
2 properties 2 required
ExternalIdReferenceSchema_MultiSelectSchema_
object
2 properties 2 required
ExternalIdReferenceSchema_StringSchema_
object
2 properties 2 required
ExternalIdReferenceSchema_VendorOutputSchema_
object
2 properties 2 required
FulfillmentMethodType
string
FundingSource
string
FundingSourceSchema
object
2 properties 2 required
GLCodeInputListSchema
object
2 properties 2 required
GLCodeInputSchema
object
6 properties 3 required
GLCodeOutputSchema
object
7 properties 3 required
LineSchema
object
7 properties 4 required
MerchantSchema
object
3 properties 2 required
MoneyValueSchema
object
2 properties 2 required
MoneyValueWithOptionalCurrencySchema
object
2 properties 2 required
MultiSelectSchema
object
5 properties 3 required
MultiSelectValue
object
2 properties 2 required
MultiSelectValueInputSchema
object
2 properties 2 required
NameExternalIdReferenceSchema_BillPayeeSchema_
object
3 properties 3 required
NameExternalIdReferenceSchema_Self_
object
3 properties 3 required
NameExternalIdReferenceSchema_SubsidiarySchema_
object
3 properties 3 required
NameReferenceSchema_AccountingVendor_
object
2 properties 2 required
NameReferenceSchema_ApprovalGroupSchema_
object
2 properties 2 required
NameReferenceSchema_ApprovalPolicySchema_
object
2 properties 2 required
NameReferenceSchema_BillAttachmentSchema_
object
2 properties 2 required
NameReferenceSchema_CardSchema_
object
2 properties 2 required
NameReferenceSchema_CustomFieldSchema_
object
2 properties 2 required
NameReferenceSchema_CustomFieldsPolicyRule_
object
2 properties 2 required
NameReferenceSchema_GLCode_
object
2 properties 2 required
NameReferenceSchema_GenericTag_
object
2 properties 2 required
NameReferenceSchema_TaxCode_
object
2 properties 2 required
NameReferenceSchema_TeamSchema_
object
2 properties 2 required
NameReferenceSchema_VendorOutputSchema_
object
2 properties 2 required
NullEnum
null
OptionInputSchema
object
2 properties 1 required
OptionSchema
object
4 properties 3 required
OrderByTypes
string
OverrideAutoPauseInputSchema
object
3 properties 3 required
OverrideSubmissionPolicyInputSchema
object
1 property 1 required
PagedResponseWebhookSubscriptionSchema
object
8 properties 8 required
PagedResponse_AccountTransactionSchema
object
6 properties 6 required
PagedResponse_PaymentSchema
object
6 properties 6 required
PatchedAccountingConnectionUpdateSchema
object
1 property
PatchedBillBatchUpdateSchema
object
2 properties
PatchedBillUpdateSchema
object
1 property
PatchedCardTransactionBatchUpdateSchema
object
2 properties
PatchedCardTransactionUpdateSchema
object
3 properties
PatchedReimbursementReportBatchUpdateSchema
object
2 properties
PatchedReimbursementReportUpdateSchema
object
3 properties
PatchedTaxCodeUpdateSchema
object
3 properties
PatchedUpdateCustomFieldOptionSchema
object
3 properties
PatchedUpdateCustomFieldSchema
object
2 properties
PatchedUpdateGLCodeSchema
object
Schema for updating a GL Code via PATCH request.
4 properties
PatchedVendorUpdateSchema
object
4 properties
PayableType
string
PaymentSchema
object
9 properties 9 required
PostingDateType
string
PostingDateTypeEnum
string
CURRENTDATE - CURRENTDATE LASTTRANSACTIONDATE - LASTTRANSACTIONDATE CUSTOMDATE - CUSTOMDATE
ReceiptSchema
object
5 properties 4 required
ReferenceSchema_AccountTransactionSchema_
object
1 property 1 required
ReferenceSchema_BillSchema_
object
1 property 1 required
ReferenceSchema_CardTransactionSchema_
object
1 property 1 required
ReferenceSchema_ReceiptSchema_
object
1 property 1 required
ReferenceSchema_TeamSchema_
object
1 property 1 required
ReimbursementReportSchema
object
20 properties 16 required
ReimbursementReportUpdateSchema
object
3 properties
ReimbursementType
string
ReloadIntervalType
string
ReviewStatusEnum
string
RoleEnum
string
RuleFieldSchema
object
2 properties 2 required
RulesSchema
object
7 properties 7 required
SpendComplianceStatus
string
StatusEnum
string
MARKEDASPAID - MARKEDASPAID PENDINGPAYMENTAPPROVAL - PENDINGPAYMENTAPPROVAL PENDINGAPPROVAL - PENDINGAPPROVAL
StringSchema
object
4 properties 2 required
StringValue
object
2 properties 2 required
StringValueInputSchema
object
2 properties 2 required
SubmissionPolicySchema
object
6 properties 6 required
SubsidiarySchema
object
5 properties 4 required
SyncInputSchema
object
1 property
TaxCodeAmountSchema
object
2 properties 1 required
TaxCodeAmountWithOptionalCurrencySchema
object
2 properties 1 required
TaxCodeInputListSchema
object
2 properties 2 required
TaxCodeInputSchema
object
3 properties 1 required
TaxCodeOutputSchema
object
5 properties 3 required
TaxComponentAmountSchema
object
2 properties 2 required
TaxComponentAmountWithOptionalCurrencySchema
object
2 properties 2 required
TaxComponentInputSchema
object
3 properties 2 required
TaxComponentOutputSchema
object
4 properties 3 required
TeamSchema
object
6 properties 6 required
UpdateFailureSchema
object
2 properties 2 required
UpdatedCustomFieldSchema
UserCreateInputSchema
object
8 properties 5 required
UserSchema
object
8 properties 7 required
VendorInputListSchema
object
2 properties 2 required
VendorInputSchema
object
4 properties 1 required
VendorOutputSchema
object
5 properties 2 required
VendorUpdateSchemaCurrencyEnum
string
AFN - AFN ALL - ALL DZD - DZD USD - USD EUR - EUR AOA - AOA XCD - XCD ARS - ARS AMD - AMD AWG - AWG AUD - AUD AZN - AZN BSD - BSD BHD - BHD BDT - BDT BBD - BBD…
WebhookPreference
object
1 property 1 required
WebhookSubscriptionOutputSchema
object
4 properties 4 required
WorkflowType
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

float-financial-openapi.yml Raw ↑
Where this information came from

This is an independent, third-party profile of Float Public API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.