Mercoa entity > representative API
The entity > representative API from Mercoa — 3 operation(s) for entity > representative.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/mercoa:mercoa-entity-representative-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Reference entity > representative API
version: 1.0.0
servers:
- url: https://api.mercoa.com
description: Production
tags:
- name: entity > representative
paths:
/entity/{entityId}/representatives:
get:
operationId: entity_representative_getAll
summary: Get All
description: Get representatives for an entity
tags:
- entity > representative
parameters:
- name: entityId
in: path
description: Entity ID or Entity ForeignID
required: true
schema:
$ref: '#/components/schemas/entityTypes_EntityId'
responses:
'200':
description: Response with status 200
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/entityTypes_RepresentativeResponse'
'400':
description: Error response with status 400
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- BadRequest
content:
type: string
required:
- errorName
- content
'401':
description: Error response with status 401
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unauthorized
content:
type: string
required:
- errorName
- content
'403':
description: Error response with status 403
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Forbidden
content:
type: string
required:
- errorName
- content
'404':
description: Error response with status 404
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- NotFound
content:
type: string
required:
- errorName
- content
'409':
description: Error response with status 409
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Conflict
content:
type: string
required:
- errorName
- content
'500':
description: Error response with status 500
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- InternalServerError
content:
type: string
required:
- errorName
- content
'501':
description: Error response with status 501
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unimplemented
content:
type: string
required:
- errorName
- content
security:
- default: []
/entity/{entityId}/representative:
post:
operationId: entity_representative_create
summary: Create
tags:
- entity > representative
parameters:
- name: entityId
in: path
description: Entity ID or Entity ForeignID
required: true
schema:
$ref: '#/components/schemas/entityTypes_EntityId'
responses:
'200':
description: Response with status 200
content:
application/json:
schema:
$ref: '#/components/schemas/entityTypes_RepresentativeResponse'
'400':
description: Error response with status 400
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- BadRequest
content:
type: string
required:
- errorName
- content
'401':
description: Error response with status 401
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unauthorized
content:
type: string
required:
- errorName
- content
'403':
description: Error response with status 403
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Forbidden
content:
type: string
required:
- errorName
- content
'404':
description: Error response with status 404
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- NotFound
content:
type: string
required:
- errorName
- content
'409':
description: Error response with status 409
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Conflict
content:
type: string
required:
- errorName
- content
'500':
description: Error response with status 500
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- InternalServerError
content:
type: string
required:
- errorName
- content
'501':
description: Error response with status 501
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unimplemented
content:
type: string
required:
- errorName
- content
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/entityTypes_RepresentativeRequest'
security:
- default: []
/entity/{entityId}/representative/{representativeId}:
get:
operationId: entity_representative_get
summary: Get
tags:
- entity > representative
parameters:
- name: entityId
in: path
description: Entity ID or Entity ForeignID
required: true
schema:
$ref: '#/components/schemas/entityTypes_EntityId'
- name: representativeId
in: path
required: true
schema:
$ref: '#/components/schemas/entityTypes_RepresentativeId'
responses:
'200':
description: Response with status 200
content:
application/json:
schema:
$ref: '#/components/schemas/entityTypes_RepresentativeResponse'
'400':
description: Error response with status 400
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- BadRequest
content:
type: string
required:
- errorName
- content
'401':
description: Error response with status 401
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unauthorized
content:
type: string
required:
- errorName
- content
'403':
description: Error response with status 403
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Forbidden
content:
type: string
required:
- errorName
- content
'404':
description: Error response with status 404
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- NotFound
content:
type: string
required:
- errorName
- content
'409':
description: Error response with status 409
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Conflict
content:
type: string
required:
- errorName
- content
'500':
description: Error response with status 500
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- InternalServerError
content:
type: string
required:
- errorName
- content
'501':
description: Error response with status 501
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unimplemented
content:
type: string
required:
- errorName
- content
security:
- default: []
post:
operationId: entity_representative_update
summary: Update
tags:
- entity > representative
parameters:
- name: entityId
in: path
description: Entity ID or Entity ForeignID
required: true
schema:
$ref: '#/components/schemas/entityTypes_EntityId'
- name: representativeId
in: path
required: true
schema:
$ref: '#/components/schemas/entityTypes_RepresentativeId'
responses:
'200':
description: Response with status 200
content:
application/json:
schema:
$ref: '#/components/schemas/entityTypes_RepresentativeResponse'
'400':
description: Error response with status 400
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- BadRequest
content:
type: string
required:
- errorName
- content
'401':
description: Error response with status 401
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unauthorized
content:
type: string
required:
- errorName
- content
'403':
description: Error response with status 403
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Forbidden
content:
type: string
required:
- errorName
- content
'404':
description: Error response with status 404
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- NotFound
content:
type: string
required:
- errorName
- content
'409':
description: Error response with status 409
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Conflict
content:
type: string
required:
- errorName
- content
'500':
description: Error response with status 500
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- InternalServerError
content:
type: string
required:
- errorName
- content
'501':
description: Error response with status 501
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unimplemented
content:
type: string
required:
- errorName
- content
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/entityTypes_RepresentativeUpdateRequest'
security:
- default: []
delete:
operationId: entity_representative_delete
summary: Delete
tags:
- entity > representative
parameters:
- name: entityId
in: path
description: Entity ID or Entity ForeignID
required: true
schema:
$ref: '#/components/schemas/entityTypes_EntityId'
- name: representativeId
in: path
required: true
schema:
$ref: '#/components/schemas/entityTypes_RepresentativeId'
responses:
'200':
description: Successful response
'400':
description: Error response with status 400
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- BadRequest
content:
type: string
required:
- errorName
- content
'401':
description: Error response with status 401
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unauthorized
content:
type: string
required:
- errorName
- content
'403':
description: Error response with status 403
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Forbidden
content:
type: string
required:
- errorName
- content
'404':
description: Error response with status 404
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- NotFound
content:
type: string
required:
- errorName
- content
'409':
description: Error response with status 409
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Conflict
content:
type: string
required:
- errorName
- content
'500':
description: Error response with status 500
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- InternalServerError
content:
type: string
required:
- errorName
- content
'501':
description: Error response with status 501
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unimplemented
content:
type: string
required:
- errorName
- content
security:
- default: []
components:
schemas:
commons_IndividualGovernmentID:
type: object
properties:
ssn:
type: string
description: Full Social Security Number. Must be in the format 123-45-6789.
required:
- ssn
title: IndividualGovernmentID
entityTypes_RepresentativeResponse:
type: object
properties:
id:
$ref: '#/components/schemas/entityTypes_RepresentativeId'
name:
$ref: '#/components/schemas/commons_FullName'
phone:
$ref: '#/components/schemas/commons_PhoneNumber'
email:
type: string
address:
$ref: '#/components/schemas/commons_Address'
birthDateProvided:
type: boolean
governmentIDProvided:
type: boolean
responsibilities:
$ref: '#/components/schemas/entityTypes_Responsibilities'
createdOn:
type: string
format: date-time
updatedOn:
type: string
format: date-time
disabledOn:
type: string
format: date-time
required:
- id
- name
- address
- birthDateProvided
- governmentIDProvided
- responsibilities
- createdOn
- updatedOn
title: RepresentativeResponse
commons_PhoneNumber:
type: object
properties:
countryCode:
type: string
number:
type: string
required:
- countryCode
- number
title: PhoneNumber
entityTypes_Responsibilities:
type: object
properties:
jobTitle:
type: string
isController:
type: boolean
description: Indicates whether this individual has significant management responsibilities within the business
isOwner:
type: boolean
description: Indicates whether this individual has an ownership stake of at least 25% in the business
ownershipPercentage:
type: integer
description: Percentage of ownership in the business. Must be between 0 and 100.
title: Responsibilities
commons_Address:
type: object
properties:
addressLine1:
type: string
addressLine2:
type: string
city:
type: string
stateOrProvince:
type: string
description: State or province code. Must be in the format XX.
postalCode:
type: string
description: Postal code. Must be in the format XXXXX or XXXXX-XXXX.
country:
type: string
required:
- addressLine1
- city
- stateOrProvince
- postalCode
title: Address
commons_BirthDate:
type: object
properties:
day:
type: string
month:
type: string
year:
type: string
title: BirthDate
entityTypes_RepresentativeRequest:
type: object
properties:
name:
$ref: '#/components/schemas/commons_FullName'
phone:
$ref: '#/components/schemas/commons_PhoneNumber'
description: Either phone or email is required.
email:
type: string
description: Either phone or email is required.
address:
$ref: '#/components/schemas/commons_Address'
birthDate:
$ref: '#/components/schemas/commons_BirthDate'
governmentID:
$ref: '#/components/schemas/commons_IndividualGovernmentID'
responsibilities:
$ref: '#/components/schemas/entityTypes_Responsibilities'
required:
- name
- address
- birthDate
- governmentID
- responsibilities
title: RepresentativeRequest
entityTypes_EntityId:
type: string
title: EntityId
commons_FullName:
type: object
properties:
firstName:
type: string
middleName:
type: string
lastName:
type: string
suffix:
type: string
required:
- firstName
- lastName
title: FullName
entityTypes_RepresentativeUpdateRequest:
type: object
properties:
name:
$ref: '#/components/schemas/commons_FullName'
phone:
$ref: '#/components/schemas/commons_PhoneNumber'
email:
type: string
address:
$ref: '#/components/schemas/commons_Address'
birthDate:
$ref: '#/components/schemas/commons_BirthDate'
governmentID:
$ref: '#/components/schemas/commons_IndividualGovernmentID'
responsibilities:
$ref: '#/components/schemas/entityTypes_Responsibilities'
title: RepresentativeUpdateRequest
entityTypes_RepresentativeId:
type: string
title: RepresentativeId
securitySchemes:
default:
type: http
scheme: bearer