Get an entity

GET

entities

{entityId}

Get an entity

const options = {method: 'GET', headers: {'api-key': '<api-key>'}};

fetch('https://api.melio.com/v2/entities/{entityId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://api.melio.com/v2/entities/{entityId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.melio.com/v2/entities/{entityId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "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]"
  }
}

{
  "error": {
    "message": "<string>",
    "details": {}
  }
}

Authorizations

api-key

string

header

required

Path Parameters

entityId

string

required

An entity id (ent_) or the sentinel me (the partner's sole entity).

Response

The entity.

string

required

Opaque entity id (ent_)

type

enum<string>

required

Available options:

business

externalId

string

metadata

object

Free-form string key/value pairs stored and returned verbatim, never interpreted by Melio. Up to 50 keys; each key 1 to 40 chars and may not contain square brackets ([ ], reserved for the metadata[key] filter); value ≤100 chars. Filterable via metadata[key].

Hide child attributes

metadata.{key}

string

Maximum string length: 100

createdAt

string<date-time>

updatedAt

string<date-time>

name

string

legalName

string

businessType

string

taxInfo

object

Hide child attributes

taxInfo.type

enum<string>

Available options:

ein,

ssn,

itin

taxInfo.identifierLast4

string

phoneNumber

string

contact

object

Contact as returned in responses; fields may be absent when the stored record is incomplete.

Hide child attributes

contact.firstName

string

contact.lastName

string

website

string

description

string

address

object

Address as returned in responses; fields may be absent when the stored record is incomplete.

Hide child attributes

address.line1

string

address.line2

string

address.city

string

address.state

string

address.postalCode

string

address.aptNumber

string

address.countryCode

string

legalAddress

object

Address as returned in responses; fields may be absent when the stored record is incomplete.

Hide child attributes

legalAddress.line1

string

legalAddress.line2

string

legalAddress.city

string

legalAddress.state

string

legalAddress.postalCode

string

legalAddress.aptNumber

string

legalAddress.countryCode

string

industry

object

Hide child attributes

industry.naicsCode

string

required

NAICS industry classification code (digits).

Pattern: ^[0-9]+$

industry.name

string

owner

object

Hide child attributes

owner.firstName

string

owner.lastName

string

owner.email

string

⌘I

Get an entity

const options = {method: 'GET', headers: {'api-key': '<api-key>'}};

fetch('https://api.melio.com/v2/entities/{entityId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://api.melio.com/v2/entities/{entityId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.melio.com/v2/entities/{entityId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "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]"
  }
}

{
  "error": {
    "message": "<string>",
    "details": {}
  }
}

Entities

Accounts

Payments

Tools

Webhooks

Authorizations

Path Parameters

Response