Return only the entity whose externalId matches (your own id).
metadata
object
Filter by metadata key/value pairs, e.g. metadata[crmId]=C-1. Matches entities whose metadata contains every supplied pair.
Hide child attributes
metadata.{key}]
string
Response
200 - application/json
Entities (limitations omitted; fetch an entity's limitations separately).
data
object[]
Hide child attributes
data.id
string
required
Opaque entity id (ent_)
data.type
enum<string>
required
Available options:
business
data.externalId
string
data.metadata
object
Free-form string key/value pairs stored and returned verbatim, never interpreted by Melio. Up to 500 keys; each key 1 to 40 chars and may not contain square brackets ([], reserved for the metadata[key] filter); value ≤100 chars. The whole object must serialize to at most 128KB of JSON. Filterable via metadata[key].
Hide child attributes
data.metadata.{key}
string
Maximum string length: 100
data.createdAt
string<date-time>
data.updatedAt
string<date-time>
data.name
string
data.legalName
string
data.businessType
string
data.taxInfo
object
Hide child attributes
data.taxInfo.type
enum<string>
Available options:
ein,
ssn,
itin
data.taxInfo.identifierLast4
string
data.phoneNumber
string
data.contact
object
Contact as returned in responses; fields may be absent when the stored record is incomplete.
Hide child attributes
data.contact.firstName
string
data.contact.lastName
string
data.website
string
data.description
string
data.address
object
Address as returned in responses; fields may be absent when the stored record is incomplete.
Hide child attributes
data.address.line1
string
data.address.line2
string
data.address.city
string
data.address.state
string
data.address.postalCode
string
data.address.aptNumber
string
data.address.countryCode
string
data.legalAddress
object
Address as returned in responses; fields may be absent when the stored record is incomplete.
Hide child attributes
data.legalAddress.line1
string
data.legalAddress.line2
string
data.legalAddress.city
string
data.legalAddress.state
string
data.legalAddress.postalCode
string
data.legalAddress.aptNumber
string
data.legalAddress.countryCode
string
data.industry
object
Hide child attributes
data.industry.naicsCode
string
required
NAICS industry classification code (digits).
Pattern: ^[0-9]+$
data.industry.name
string
data.owner
object
Hide child attributes
data.owner.firstName
string
data.owner.lastName
string
data.owner.email
string
data.termsAcceptance
object
The terms of service acceptance on file for this business. Absent when none has been recorded.
{"docsConfig":{"theme":"sequoia","$schema":"https://mintlify.com/docs.json","name":"Melio Payouts API","colors":{"primary":"#7849ff","light":"#b79eff","dark":"#5f33e6"},"logo":{"light":"https://mintcdn.com/melio/xvWXKzlr8EBNoRDW/images/melio-wordmark.svg?fit=max\u0026auto=format\u0026n=xvWXKzlr8EBNoRDW\u0026q=85\u0026s=64c5b00a44de83a5745e570ecf3d0fc2","dark":"https://mintcdn.com/melio/-5UmKJJuHDVMiDrl/images/melio-wordmark-invert.svg?fit=max\u0026auto=format\u0026n=-5UmKJJuHDVMiDrl\u0026q=85\u0026s=d39c348234f65d6b306ccd6084ebbc01","href":"https://melio.com/"},"favicon":{"light":"https://mintcdn.com/melio/J5BJFv_c5fQarBeJ/images/cropped-Melio_favicon_01-64x64.webp?fit=max\u0026auto=format\u0026n=J5BJFv_c5fQarBeJ\u0026q=85\u0026s=9f502b845554081800303c51cbf82a7c","dark":"https://mintcdn.com/melio/J5BJFv_c5fQarBeJ/images/cropped-Melio_favicon_01-64x64.webp?fit=max\u0026auto=format\u0026n=J5BJFv_c5fQarBeJ\u0026q=85\u0026s=9f502b845554081800303c51cbf82a7c"},"api":{"openapi":"openapi.json","params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["typescript","python","curl","java","ruby","go"],"prefill":true,"autogenerate":true},"url":"full","mdx":{"auth":{"method":"basic","name":"api-key"},"server":["https://api.staging01.melio.com","https://api.melio.com"]}},"background":{"color":{"dark":"#262D38"}},"navbar":{"links":[{"href":"https://developers.melio.com/contact","label":"Contact us"},{"href":"https://developers.melio.com/sign-in","label":"Log in"}],"primary":{"type":"button","label":"Sign up for beta","href":"https://developers.melio.com/sign-up"}},"seo":{"indexing":"navigable"},"fonts":{"family":"Inter"},"icons":{"library":"lucide"},"integrations":{"segment":{"key":"EJ3N2VRhwnd0eFx5CFt1BobojP0OF4GS"}},"markdown":{"schema":true},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"melio","hasAudioNarration":false,"actualSubdomain":"melio","customDomains":["developers.melio.com"],"gitSource":{"type":"github","owner":"melio","repo":"payouts-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae0ec738cfebfdf07ee030c"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af47aa92d65da0928c63ec7","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Documentation","count":32},{"language":"default","tag":"API Reference","count":24},{"language":"default","tag":"Tools","count":10},{"language":"default","tag":"Building with the API","count":8},{"language":"default","tag":"Entities","count":7},{"language":"default","tag":"Core resources","count":6},{"language":"default","tag":"Risk, compliance \u0026 going live","count":6},{"language":"default","tag":"Accounts","count":6},{"language":"default","tag":"Payments","count":6},{"language":"default","tag":"Get started","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".sidebar-group-header{font-size:0.9rem!important;font-weight:500!important;letter-spacing:0.01em}#page-title{font-size:2rem;line-height:1.25}#header .eyebrow{font-size:0.7rem!important}#header .prose{font-size:1rem!important}"}],"page":{"pagePath":"api-reference/entities/list-entities","slug":"/api-reference/entities/list-entities","pageMetadata":{"title":"List entities","description":"Returns your entities, newest first. Use the filters below to narrow the list.","deprecated":null,"version":null,"openapi":"/openapi.json get /entities","href":"/api-reference/entities/list-entities","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns your entities, newest first. Use the filters below to narrow the list.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List entities","description":"Returns your entities, newest first. Use the filters below to narrow the list.","deprecated":null,"version":null,"openapi":"/openapi.json get /entities","href":"/api-reference/entities/list-entities","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Entities"],"summary":"List entities","description":"Returns your entities, newest first. Use the filters below to narrow the list.","security":["70d27737-867f-465b-ba3c-4a3197cd2915"],"parameters":["aec46584-ebd2-4ba8-b407-bacd90c9d76e","72ba8fa6-3a50-4836-b646-57176a747d94"],"responses":{"200":"5df5954f-ae79-4b5c-b0e8-b903d2066bb5"},"method":"get","type":"path","servers":["11023ec5-d3f9-4571-b97f-e305433ac479","a9b4dcdc-ad19-4ca1-80f3-760819968e97"],"path":"/entities","baseUrlOptions":["https://api.melio.com/v2","https://api.staging01.melio.com/v2"],"title":"List entities","codeSamples":[],"requestExampleLanguages":["typescript","python","bash","java","ruby","go"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[],"urlDisplay":"full"},"dependencies":{"parameters":{"aec46584-ebd2-4ba8-b407-bacd90c9d76e":{"name":"externalId","in":"query","required":false,"description":"Return only the entity whose `externalId` matches (your own id).","schema":{"type":"string","isRequired":false,"description":"Return only the entity whose `externalId` matches (your own id).","uniqueKey":"","typeLabel":"string"}},"72ba8fa6-3a50-4836-b646-57176a747d94":{"name":"metadata","in":"query","required":false,"style":"deepObject","explode":true,"description":"Filter by metadata key/value pairs, e.g. `metadata[crmId]=C-1`. Matches entities whose metadata contains every supplied pair.\n","schema":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"additionalProperties","typeLabel":"string"},"isRequired":false,"description":"Filter by metadata key/value pairs, e.g. `metadata[crmId]=C-1`. Matches entities whose metadata contains every supplied pair.\n","uniqueKey":"","typeLabel":"object"}}},"responses":{"5df5954f-ae79-4b5c-b0e8-b903d2066bb5":{"description":"Entities (limitations omitted; fetch an entity's limitations separately).","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","type"],"properties":{"id":{"type":"string","description":"Opaque entity id (ent_\u003cuuid>)","isRequired":true,"uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["business"],"isRequired":true,"uniqueKey":"data.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"externalId":{"type":"string","uniqueKey":"data.items.[INDEX].externalId","typeLabel":"string"},"metadata":{"type":"object","description":"Free-form string key/value pairs stored and returned verbatim, never interpreted by Melio. Up to 500 keys; each key 1 to 40 chars and may not contain square brackets (`[` `]`, reserved for the `metadata[key]` filter); value ≤100 chars. The whole object must serialize to at most 128KB of JSON. Filterable via `metadata[key]`.\n","additionalProperties":{"type":"string","maxLength":100,"uniqueKey":"data.items.[INDEX].metadata.additionalProperties","typeLabel":"string"},"maxProperties":500,"uniqueKey":"data.items.[INDEX].metadata","typeLabel":"object"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"data.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","uniqueKey":"data.items.[INDEX].updatedAt","typeLabel":"string\u003cdate-time>"},"name":{"type":"string","uniqueKey":"data.items.[INDEX].name","typeLabel":"string"},"legalName":{"type":"string","uniqueKey":"data.items.[INDEX].legalName","typeLabel":"string"},"businessType":{"type":"string","uniqueKey":"data.items.[INDEX].businessType","typeLabel":"string"},"taxInfo":{"type":"object","properties":{"type":{"type":"string","enum":["ein","ssn","itin"],"uniqueKey":"data.items.[INDEX].taxInfo.type","typeLabel":"enum\u003cstring>"},"identifierLast4":{"type":"string","uniqueKey":"data.items.[INDEX].taxInfo.identifierLast4","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX].taxInfo","typeLabel":"object"},"phoneNumber":{"type":"string","uniqueKey":"data.items.[INDEX].phoneNumber","typeLabel":"string"},"contact":{"type":"object","description":"Contact as returned in responses; fields may be absent when the stored record is incomplete.","properties":{"firstName":{"type":"string","uniqueKey":"data.items.[INDEX].contact.firstName","typeLabel":"string"},"lastName":{"type":"string","uniqueKey":"data.items.[INDEX].contact.lastName","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX].contact","typeLabel":"object"},"website":{"type":"string","uniqueKey":"data.items.[INDEX].website","typeLabel":"string"},"description":{"type":"string","uniqueKey":"data.items.[INDEX].description","typeLabel":"string"},"address":{"type":"object","description":"Address as returned in responses; fields may be absent when the stored record is incomplete.","properties":{"line1":{"type":"string","uniqueKey":"data.items.[INDEX].address.line1","typeLabel":"string"},"line2":{"type":"string","uniqueKey":"data.items.[INDEX].address.line2","typeLabel":"string"},"city":{"type":"string","uniqueKey":"data.items.[INDEX].address.city","typeLabel":"string"},"state":{"type":"string","uniqueKey":"data.items.[INDEX].address.state","typeLabel":"string"},"postalCode":{"type":"string","uniqueKey":"data.items.[INDEX].address.postalCode","typeLabel":"string"},"aptNumber":{"type":"string","uniqueKey":"data.items.[INDEX].address.aptNumber","typeLabel":"string"},"countryCode":{"type":"string","uniqueKey":"data.items.[INDEX].address.countryCode","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX].address","typeLabel":"object"},"legalAddress":{"type":"object","description":"Address as returned in responses; fields may be absent when the stored record is incomplete.","properties":{"line1":{"type":"string","uniqueKey":"data.items.[INDEX].legalAddress.line1","typeLabel":"string"},"line2":{"type":"string","uniqueKey":"data.items.[INDEX].legalAddress.line2","typeLabel":"string"},"city":{"type":"string","uniqueKey":"data.items.[INDEX].legalAddress.city","typeLabel":"string"},"state":{"type":"string","uniqueKey":"data.items.[INDEX].legalAddress.state","typeLabel":"string"},"postalCode":{"type":"string","uniqueKey":"data.items.[INDEX].legalAddress.postalCode","typeLabel":"string"},"aptNumber":{"type":"string","uniqueKey":"data.items.[INDEX].legalAddress.aptNumber","typeLabel":"string"},"countryCode":{"type":"string","uniqueKey":"data.items.[INDEX].legalAddress.countryCode","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX].legalAddress","typeLabel":"object"},"industry":{"type":"object","required":["naicsCode"],"properties":{"naicsCode":{"type":"string","description":"NAICS industry classification code (digits).","pattern":"^[0-9]+$","isRequired":true,"uniqueKey":"data.items.[INDEX].industry.naicsCode","typeLabel":"string"},"name":{"type":"string","uniqueKey":"data.items.[INDEX].industry.name","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX].industry","typeLabel":"object"},"owner":{"type":"object","properties":{"firstName":{"type":"string","uniqueKey":"data.items.[INDEX].owner.firstName","typeLabel":"string"},"lastName":{"type":"string","uniqueKey":"data.items.[INDEX].owner.lastName","typeLabel":"string"},"email":{"type":"string","uniqueKey":"data.items.[INDEX].owner.email","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX].owner","typeLabel":"object"},"termsAcceptance":{"type":"object","description":"The terms of service acceptance on file for this business. Absent when none has been recorded.\n","properties":{"acceptedAt":{"type":"string","format":"date-time","uniqueKey":"data.items.[INDEX].termsAcceptance.acceptedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data.items.[INDEX].termsAcceptance","typeLabel":"object"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":[{"id":"ent_7c9e6679-7425-40de-944b-e07fc1f90ae7","type":"business","externalId":"partner-biz-1234","createdAt":"2026-07-08T15:00:00Z","updatedAt":"2026-07-08T15:00:00Z","name":"Acme Supplies","legalName":"Acme Supplies LLC","businessType":"llc","taxInfo":{"type":"ein","identifierLast4":"6789"},"phoneNumber":"+12125551234","contact":{"firstName":"Jane","lastName":"Doe"},"website":"https://acmesupplies.com","address":{"line1":"350 5th Ave","city":"New York","state":"NY","postalCode":"10118","countryCode":"US"},"legalAddress":{"line1":"350 5th Ave","city":"New York","state":"NY","postalCode":"10118","countryCode":"US"},"industry":{"naicsCode":"424410"},"owner":{"firstName":"Jane","lastName":"Doe","email":"[email protected]"}}]},"examples":{"Example":{"title":"Example","value":{"data":[{"id":"ent_7c9e6679-7425-40de-944b-e07fc1f90ae7","type":"business","externalId":"partner-biz-1234","createdAt":"2026-07-08T15:00:00Z","updatedAt":"2026-07-08T15:00:00Z","name":"Acme Supplies","legalName":"Acme Supplies LLC","businessType":"llc","taxInfo":{"type":"ein","identifierLast4":"6789"},"phoneNumber":"+12125551234","contact":{"firstName":"Jane","lastName":"Doe"},"website":"https://acmesupplies.com","address":{"line1":"350 5th Ave","city":"New York","state":"NY","postalCode":"10118","countryCode":"US"},"legalAddress":{"line1":"350 5th Ave","city":"New York","state":"NY","postalCode":"10118","countryCode":"US"},"industry":{"naicsCode":"424410"},"owner":{"firstName":"Jane","lastName":"Doe","email":"[email protected]"}}]}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"70d27737-867f-465b-ba3c-4a3197cd2915":{"ApiKey":{"type":"apiKey","in":"header","name":"api-key","scopes":[],"schemeName":"ApiKey"}}},"servers":{"11023ec5-d3f9-4571-b97f-e305433ac479":{"description":"Production","url":"https://api.melio.com/v2"},"a9b4dcdc-ad19-4ca1-80f3-760819968e97":{"description":"Staging01","url":"https://api.staging01.melio.com/v2"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"api-key","scopes":[],"schemeName":"ApiKey"},"schema":{"title":"api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKey","name":"api-key"}],"title":"ApiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"melio","siteName":"Melio Payouts API","title":"List entities - Melio Payouts API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-11T07:50:53.734Z","originalFileLocation":"api-reference/entities/list-entities.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns your entities, newest first. Use the filters below to narrow the list.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Melio Payouts API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/melio/9sciKkVs_XIsdZmC/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/melio/9sciKkVs_XIsdZmC/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/melio/9sciKkVs_XIsdZmC/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/melio/9sciKkVs_XIsdZmC/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/melio/9sciKkVs_XIsdZmC/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/melio/9sciKkVs_XIsdZmC/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/melio/9sciKkVs_XIsdZmC/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/melio/9sciKkVs_XIsdZmC/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/melio/9sciKkVs_XIsdZmC/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List entities - Melio Payouts API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns your entities, newest first. Use the filters below to narrow the list.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Melio Payouts API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.melio.com/docs/api-reference/entities/list-entities\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://melio.mintlify.site/docs/_mintlify/api/og/v2?division=Entities\u0026amp;title=List+entities\u0026amp;description=Returns+your+entities%2C+newest+first.+Use+the+filters+below+to+narrow+the+list.\u0026amp;theme=840e77e176f335a47137ea1a\u0026amp;signature=3c13ea6dd690c0d130e2c6b49dd6440f713e28cda2e424e8974b6e3e7f655925\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List entities - Melio Payouts API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns your entities, newest first. Use the filters below to narrow the list.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://melio.mintlify.site/docs/_mintlify/api/og/v2?division=Entities\u0026amp;title=List+entities\u0026amp;description=Returns+your+entities%2C+newest+first.+Use+the+filters+below+to+narrow+the+list.\u0026amp;theme=840e77e176f335a47137ea1a\u0026amp;signature=3c13ea6dd690c0d130e2c6b49dd6440f713e28cda2e424e8974b6e3e7f655925\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/melio/9sciKkVs_XIsdZmC/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Melio Payouts API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7849ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.melio.com/docs/api-reference/entities/list-entities\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/entities/list-entities.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.melio.com/#organization\",\"name\":\"Melio Payouts API\",\"url\":\"https://developers.melio.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/melio/xvWXKzlr8EBNoRDW/images/melio-wordmark.svg?fit=max\u0026auto=format\u0026n=xvWXKzlr8EBNoRDW\u0026q=85\u0026s=64c5b00a44de83a5745e570ecf3d0fc2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.melio.com/docs#website\",\"name\":\"Melio Payouts API\",\"url\":\"https://developers.melio.com/docs\",\"publisher\":{\"@id\":\"https://developers.melio.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.melio.com/docs/api-reference/entities/list-entities#webpage\",\"url\":\"https://developers.melio.com/docs/api-reference/entities/list-entities\",\"name\":\"List entities\",\"description\":\"Returns your entities, newest first. Use the filters below to narrow the list.\",\"dateModified\":\"2026-11-11T07:50:53.734Z\",\"isPartOf\":{\"@id\":\"https://developers.melio.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://developers.melio.com/docs/api-reference/entities/list-entities#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.melio.com/docs/api-reference/entities/list-entities#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Melio Payouts API\",\"item\":\"https://developers.melio.com/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List entities\",\"item\":\"https://developers.melio.com/docs/api-reference/entities/list-entities\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.melio.com/docs/api-reference/entities/list-entities#apireference\",\"headline\":\"List entities\",\"name\":\"List entities\",\"description\":\"Returns your entities, newest first. Use the filters below to narrow the list.\",\"url\":\"https://developers.melio.com/docs/api-reference/entities/list-entities\",\"mainEntityOfPage\":{\"@id\":\"https://developers.melio.com/docs/api-reference/entities/list-entities#webpage\"},\"dateModified\":\"2026-11-11T07:50:53.734Z\",\"publisher\":{\"@id\":\"https://developers.melio.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.melio.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Melio Payouts API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Melio Payouts API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/entities/list-entities.md","siteName":"Melio Payouts API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/Introduction"}]},{"tab":"API Reference","groups":[{"group":"Entities","pages":[{"title":"List entities","deprecated":null,"version":null,"openapi":"/openapi.json get /entities","href":"/api-reference/entities/list-entities"},{"title":"Create an entity","description":"Creates an entity (a business). A direct partner manages a single entity; a platform partner can create as many as it needs.\n","deprecated":null,"version":null,"openapi":"/openapi.json post /entities","href":"/api-reference/entities/create-an-entity"},{"title":"Get an entity","deprecated":null,"version":null,"openapi":"/openapi.json get /entities/{entityId}","href":"/api-reference/entities/get-an-entity"},{"title":"Update an entity","deprecated":null,"version":null,"openapi":"/openapi.json patch /entities/{entityId}","href":"/api-reference/entities/update-an-entity"},{"title":"List beneficial owners","deprecated":null,"version":null,"openapi":"/openapi.json get /entities/{entityId}/beneficial-owners","href":"/api-reference/entities/list-beneficial-owners"},{"title":"Replace beneficial owners","deprecated":null,"version":null,"openapi":"/openapi.json put /entities/{entityId}/beneficial-owners","href":"/api-reference/entities/replace-beneficial-owners"},{"title":"Get limitations","deprecated":null,"version":null,"openapi":"/openapi.json get /limitations","href":"/api-reference/entities/get-limitations"}]},{"group":"Accounts","pages":[{"title":"List accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /accounts","href":"/api-reference/accounts/list-accounts"},{"title":"Create an account","deprecated":null,"version":null,"openapi":"/openapi.json post /accounts","href":"/api-reference/accounts/create-an-account"},{"title":"Create a link to add a Plaid or card account","deprecated":null,"version":null,"openapi":"/openapi.json post /accounts/link","href":"/api-reference/accounts/create-a-link-to-add-a-plaid-or-card-account"},{"title":"Get an account","deprecated":null,"version":null,"openapi":"/openapi.json get /accounts/{accountId}","href":"/api-reference/accounts/get-an-account"},{"title":"Delete an account","deprecated":null,"version":null,"openapi":"/openapi.json delete /accounts/{accountId}","href":"/api-reference/accounts/delete-an-account"},{"title":"Create a link to verify a Plaid account","deprecated":null,"version":null,"openapi":"/openapi.json post /accounts/{accountId}/verify/link","href":"/api-reference/accounts/create-a-link-to-verify-a-plaid-account"}]},{"group":"Attachments","pages":[{"title":"Upload an attachment","deprecated":null,"version":null,"openapi":"/openapi.json post /attachments","href":"/api-reference/attachments/upload-an-attachment"}]},{"group":"Payments","pages":[{"title":"List payments","deprecated":null,"version":null,"openapi":"/openapi.json get /payments","href":"/api-reference/payments/list-payments"},{"title":"Create a payment","deprecated":null,"version":null,"openapi":"/openapi.json post /payments","href":"/api-reference/payments/create-a-payment"},{"title":"Get a payment","deprecated":null,"version":null,"openapi":"/openapi.json get /payments/{paymentId}","href":"/api-reference/payments/get-a-payment"},{"title":"Update a payment","deprecated":null,"version":null,"openapi":"/openapi.json patch /payments/{paymentId}","href":"/api-reference/payments/update-a-payment"},{"title":"Cancel a payment","deprecated":null,"version":null,"openapi":"/openapi.json post /payments/{paymentId}/cancel","href":"/api-reference/payments/cancel-a-payment"},{"title":"Simulate a payment action","deprecated":null,"version":null,"openapi":"/openapi.json post /simulations/payments/{paymentId}/actions","href":"/api-reference/payments/simulate-a-payment-action"}]},{"group":"Tools","pages":[{"title":"Calculate fees","deprecated":null,"version":null,"openapi":"/openapi.json post /tools/fee-calculator","href":"/api-reference/tools/calculate-fees"},{"title":"Quote a currency conversion","deprecated":null,"version":null,"openapi":"/openapi.json post /tools/fx-quote","href":"/api-reference/tools/quote-a-currency-conversion"},{"title":"Check fast payment eligibility","deprecated":null,"version":null,"openapi":"/openapi.json post /tools/fast-payment-eligibility","href":"/api-reference/tools/check-fast-payment-eligibility"},{"title":"Estimate delivery dates","deprecated":null,"version":null,"openapi":"/openapi.json post /tools/delivery-eta","href":"/api-reference/tools/estimate-delivery-dates"}]}]}]},"basePath":"","title":"List entities - Melio Payouts API","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CQGbdtm4.js","utils-D88A1f-Z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChqWdz1A.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-yBrxdh_6.js","snippetPresets-BgqDrFJC.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-C2-BijcO.js","ApiExamples-Duxc2rZw.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C7jidOil.js","shallow-xkjpHm-U.js","getApiPlaygroundDisplay-fE3rVpvL.js","CodeSnippet-LgxljKed.js","CodeSnippets-D-pXWDHq.js","getPastedJson-CLRcu-uo.js","icon-Cxirpjgo.js","MethodPill-D49eqY5e.js","DuplicateIcon-CivCz5Rp.js","createIcon-D71qL3f5.js","DynamicMarkdown-BcGRTrw6.js","SectionHeading-DzaqmmSD.js","axios-vUo_bRtp.js","Markdown-CZqUYmMp.js","clsx-B6IZIRsp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-B0ZV6X5T.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-MqLyPtsW.js"]}