For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
API StatusPartner Portal
HomeGuidesAPI ExplorerSDKsGitHubSupport
HomeGuidesAPI ExplorerSDKsGitHubSupport
  • API Concepts
    • Overview
    • Environments and URLs
    • Authentication
    • API versioning
    • Rate limiting
    • HTTP headers
    • Pagination, sorting, and filtering
  • General
  • Common
      • GETGet all persons
      • POSTCreate a person
      • GETGet a person
      • DELDelete a person
      • PATCHUpdate a person
  • Accounts payable
  • Accounts receivable
  • E-invoicing
  • Payments
  • Accounting integration
  • Expense management
  • Utilities
LogoLogo
API StatusPartner Portal
CommonEntity persons

Get a person

GET
/persons/:person_id
GET
/v1/persons/:person_id
$curl https://api.sandbox.monite.com/v1/persons/person_id \
>     -H "x-monite-version: 2024-05-25" \
>     -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
>     -H "Authorization: Bearer <token>"
1{
2  "id": "id",
3  "created_at": "2024-01-15T09:30:00Z",
4  "updated_at": "2024-01-15T09:30:00Z",
5  "email": "email",
6  "entity_id": "entity_id",
7  "first_name": "first_name",
8  "last_name": "last_name",
9  "relationship": {
10    "director": true,
11    "executive": true,
12    "owner": true,
13    "percent_ownership": 1.1,
14    "representative": true,
15    "title": "title"
16  },
17  "address": {
18    "city": "city",
19    "country": "country",
20    "line1": "line1",
21    "postal_code": "postal_code",
22    "line2": "line2",
23    "state": "state"
24  },
25  "citizenship": "AF",
26  "created_by_entity_user_id": "created_by_entity_user_id",
27  "date_of_birth": "date_of_birth",
28  "id_number": "id_number",
29  "phone": "phone",
30  "ssn_last_4": "ssn_last_4"
31}
Was this page helpful?
Previous

Delete a person

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

person_idstringRequired

Headers

x-monite-versionstringRequired
x-monite-entity-idstringRequired
The ID of the entity that owns the requested resource.

Response

Successful Response
idstringformat: "uuid"
The person's unique identifier
created_atdatetime
Time at which the person was created
updated_atdatetime
Time at which the person was updated
emailstringformat: "email"
The person's email address
entity_idstringformat: "uuid"
Entity ID
first_namestring
The person's first name
last_namestring
The person's last name
relationshipobject
Describes the person's relationship to the entity
addressobject
The person's address
citizenshipenum

Required for persons of US entities. The country of the person’s citizenship, as a two-letter country code (ISO 3166-1 alpha-2). In case of dual or multiple citizenship, specify any.

created_by_entity_user_idstringformat: "uuid"
ID of the entity user who created this person, or null if the person was created using a partner access token.
date_of_birthstringformat: "date"
The person's date of birth
id_numberstring
The person's ID number, as appropriate for their country
phonestring
The person's phone number
ssn_last_4string
The last four digits of the person's Social Security number

Errors

401
Get Persons ID Request Unauthorized Error
404
Get Persons ID Request Not Found Error
422
Get Persons ID Request Unprocessable Entity Error
429
Get Persons ID Request Too Many Requests Error