Build on Flamingo with our API and MCP
Connect Flamingo to your own systems through the API, or to Claude, ChatGPT and other AI assistants through MCP. Access follows the same roles and permissions as your account.
Two ways to connect
APIFor your engineering team
Read and act on contractors, invoices, payouts and employees from your own systems.See the API
MCPFor your AI assistant
Ask Flamingo questions and take actions in plain language from Claude, ChatGPT or Cursor.See MCP
Read and act on Flamingo from your own systems
The Flamingo API gives your engineering team the same data you see in Flamingo: pull contractors, invoices, payouts and employees into your own tools, and act on them, like approving an invoice, with the roles and permissions of your account.
Contractors & contracts
List contractors, check onboarding status and read their contracts.
Invoices & approvals
List invoices and approve the ones waiting on you.
Payouts to 119 countries
Check where each contractor payout is, from pending to paid.
Employer of Record quotes (PH, CO)
Get a cost quote for an employee in the Philippines or Colombia.
Employees, time off & documents
EOR employees and their payslips, direct employees, time off requests and documents.
GET/v1/invoices
Request
GET /v1/invoicesHost: api.hireflamingo.comAuthorization: Bearer <your-token>Response 200
{
"data": [
{
"id": "inv_7Q2K",
"contractor": "Priya Nair",
"amount": "3100.00",
"currency": "USD",
"billing": "monthly",
"status": "awaiting_approval"
},
{
"id": "inv_5M8D",
"contractor": "Ana Reyes",
"amount": "148000.00",
"currency": "PHP",
"billing": "hourly",
"status": "approved"
},
{
"id": "inv_3H1T",
"contractor": "Camilo Restrepo",
"amount": "7400000.00",
"currency": "COP",
"billing": "fixed",
"status": "paid"
}
]
}POST/v1/invoices/{id}/approve
Request
POST /v1/invoices/inv_7Q2K/approveHost: api.hireflamingo.comAuthorization: Bearer <your-token>Response 200
{
"id": "inv_7Q2K",
"contractor": "Priya Nair",
"amount": "3100.00",
"currency": "USD",
"status": "approved"
}Approving through the API follows the same approval chain as approving in Flamingo. Base URL https://api.hireflamingo.com.
Work with Flamingo from your AI assistant
Flamingo’s MCP server connects Claude, ChatGPT, Cursor and other MCP-compatible assistants to your workspace, so you can ask questions and take actions in plain language.
- Ask which invoices are waiting for your approval
- Get an Employer of Record cost quote for the Philippines or Colombia
- See which contractors are still onboarding and what's missing
Your assistant only sees what your Flamingo role can see.
You
Which contractor invoices are waiting for my approval?
Assistant
3 invoices are waiting for your approval, including Priya Nair's $3,100.00 (monthly). Ana Reyes's ₱148,000.00 (hourly) is already approved, and Camilo Restrepo's COP 7,400,000 (fixed) has been paid.
You stay in control of what gets connected
Same roles and permissions as your account
The API and MCP use the roles and permissions already set up in your Flamingo workspace. An integration never sees more than the account it acts for.
Act only with the access you grant
Actions such as approving an invoice still follow your approval chains, exactly as they do in Flamingo.
Encrypted bank and payout details
Bank and payout details are encrypted field by field with AES-GCM before they are stored.
API and MCP questions
Who can connect, and what they can reach.
Who can use the API?
Any Flamingo customer. Request access and we'll set up credentials for your workspace.
What can the API do?
Work with contractors and their onboarding status, contracts, invoices (list and approve), payout status for payouts to 119 countries, Employer of Record cost quotes for the Philippines and Colombia, EOR employees and payslips, direct employees, time off requests and documents.
Which AI assistants work with Flamingo MCP?
Claude, ChatGPT, Cursor and other MCP-compatible assistants.
Can an assistant see everything in my account?
No. It only sees what your Flamingo role can see.