> ## Documentation Index > Fetch the complete documentation index at: https://docs.nextlevelmca.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a person > The person with their business associations and the deals they own. SSN is masked (`***-**-1234`); `dob` only for admin / manager credentials. ## OpenAPI ````yaml /openapi/public-v1.json get /v1/people/{id} openapi: 3.0.0 info: title: NextLevel MCA Public API description: >- REST API for the NextLevel MCA deal platform. Objects flow Businesses → People → Deals → Submissions → Offers → Advances. **Authentication.** Send `Authorization: Bearer ` with an API key (`nlmca_live_…`, created in Settings → Developers) or an OAuth access token. Keys are scoped to one location. **Conventions.** JSON only. Cursor pagination (`limit` ≤ 100, `cursor` from `meta.next_cursor`). Every success is `{ data, meta }`; every error is `{ error: { type, message, code, param, request_id } }`. POST endpoints accept `Idempotency-Key` (24h replay). Rate limit 300 requests/min per credential (`X-RateLimit-*` headers). **Scopes.** Keys with no scopes have all of them. Otherwise: - `businesses:read` — Read businesses and their notes, tasks and activity - `businesses:write` — Create and update businesses, notes and tasks - `people:read` — Read people (contacts and owners) - `people:write` — Create and update people - `deals:read` — Read deals, submissions and the pipeline - `deals:write` — Create and update deals, move stages - `documents:read` — Read documents and statement analysis - `documents:write` — Upload documents and request documents from merchants - `lenders:read` — Read lenders, criteria and lender matches - `lenders:write` — Create and update lenders and criteria - `submissions:write` — Submit deals to lenders and withdraw submissions - `offers:read` — Read offers - `offers:write` — Log and update offers, set the primary offer - `advances:read` — Read funded advances and renewal flags - `advances:write` — Update advances - `portal:send` — Generate and send merchant portal links - `webhooks:manage` — Manage webhook subscriptions version: '1.0' contact: {} servers: - url: https://api.nextlevelmca.com description: Production security: - bearer: [] tags: - name: Businesses description: Merchant businesses and their notes, tasks and activity - name: People description: Contacts and owners. Phone lookups normalise to E.164. - name: Deals description: Deals, stage moves, renewals and the pipeline - name: Documents description: Documents, presigned uploads, document requests and statement analysis - name: Lenders description: Lenders and their criteria - name: Lender matches description: Criteria-driven lender matching for a deal - name: Submissions description: Sending deals to lenders - name: Offers description: Lender offers and the primary offer - name: Advances description: Funded advances and renewal readiness - name: Merchant portal description: Magic links for the merchant portal - name: Webhooks description: Outbound event subscriptions paths: /v1/people/{id}: get: tags: - People summary: Get a person description: >- The person with their business associations and the deals they own. SSN is masked (`***-**-1234`); `dob` only for admin / manager credentials. operationId: people_get parameters: - name: id required: true in: path description: Person id schema: type: string responses: '200': description: OK content: application/json: schema: type: object required: - data - meta properties: data: $ref: '#/components/schemas/PersonDetailDto' meta: $ref: '#/components/schemas/EmptyMetaDto' '401': description: Missing, invalid, expired or revoked credential. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelopeDto' '403': description: Credential lacks the scope, or the role lacks the permission. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelopeDto' '404': description: Resource not found in this location. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelopeDto' '429': description: Rate limit exceeded. See `X-RateLimit-*` and `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelopeDto' security: - bearer: [] components: schemas: PersonDetailDto: type: object properties: id: type: string description: Person id. first_name: type: string description: First name. last_name: type: string nullable: true description: Last name. full_name: type: string description: First and last name joined, for display. email: type: string nullable: true phone: type: string nullable: true description: Phone as stored (any format). Lookups normalise to E.164. address: type: string nullable: true city: type: string nullable: true state: type: string nullable: true zip: type: string nullable: true dob: type: string nullable: true description: >- Date of birth `YYYY-MM-DD`. Only returned to admin / manager credentials; null for everyone else. ssn_masked: type: string nullable: true description: >- Masked SSN, e.g. `***-**-6789`, or null when none is on file. The full number is never returned. credit_score: type: string nullable: true description: Credit score or range as text. ghl_contact_id: type: string nullable: true description: Id of the mirrored CRM contact, when linked. Read-only. status: type: string nullable: true enum: - active - inactive description: '`active` or `inactive`.' created_at: type: string description: ISO 8601 UTC. updated_at: type: string description: ISO 8601 UTC. businesses: description: Businesses this person is associated with. type: array items: $ref: '#/components/schemas/PersonBusinessLinkDto' deals: description: Deals where this person is an owner, most recently updated first. type: array items: $ref: '#/components/schemas/PersonDealSummaryDto' required: - id - first_name - last_name - full_name - email - phone - address - city - state - zip - dob - ssn_masked - credit_score - ghl_contact_id - status - created_at - updated_at - businesses - deals EmptyMetaDto: type: object properties: {} ErrorEnvelopeDto: type: object properties: error: $ref: '#/components/schemas/PublicErrorDto' required: - error PersonBusinessLinkDto: type: object properties: business_id: type: string description: Business id. legal_name: type: string description: Business legal name. dba: type: string nullable: true description: Doing-business-as name. status: type: string nullable: true description: 'Business status: `active`, `inactive` or `watchlist`.' role: type: string nullable: true enum: - owner - co-owner - bookkeeper - other description: Role of the person on the business. ownership_percent: type: number nullable: true description: Ownership percentage, when known. active: type: boolean description: False when the association was deactivated. is_primary_contact: type: boolean description: True when this person is the business’s primary contact. required: - business_id - legal_name - dba - status - role - ownership_percent - active - is_primary_contact PersonDealSummaryDto: type: object properties: id: type: string description: Deal id. business_name: type: string nullable: true description: Business name on the deal. business_id: type: string nullable: true description: Business the deal belongs to. requested_amount: type: number nullable: true description: Requested funding amount. status: type: string nullable: true description: Deal status slug. stage: nullable: true description: Current pipeline stage. allOf: - $ref: '#/components/schemas/PersonDealStageDto' is_primary_owner: type: boolean description: True when this person is the deal’s primary owner. ownership_percent: type: number nullable: true description: Ownership percentage recorded on the deal. created_at: type: string description: ISO 8601 UTC. updated_at: type: string description: ISO 8601 UTC. required: - id - business_name - business_id - requested_amount - status - stage - is_primary_owner - ownership_percent - created_at - updated_at PublicErrorDto: type: object properties: type: type: string enum: - validation_error - authentication_error - permission_error - not_found - conflict - rate_limit_error - api_error message: type: string description: Human-readable explanation, safe to show to an operator or an agent. code: type: string description: >- Stable machine-readable code, e.g. `missing_scope`, `duplicate_business`. param: type: string description: Request field the error refers to, when applicable. request_id: type: string description: Echo of the `X-Request-Id` header. Quote it when contacting support. required: - type - message - request_id PersonDealStageDto: type: object properties: id: type: string label: type: string description: Stage label as shown on the board. phase: type: string enum: - preoffer - offer - contract - funded - dead required: - id - label - phase securitySchemes: bearer: scheme: bearer bearerFormat: API key or JWT type: http description: API key (`nlmca_live_…`) or OAuth access token ```` ## Related topics - [MCP server](/mcp/overview.md) - [Changelog](/changelog/changelog.md) - [Create a person](/api-reference/people/create-a-person.md)