> For the complete documentation index, see [llms.txt](https://flapjax.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://flapjax.gitbook.io/docs/rest-api/reference/people-events/get-person-by-uuid.md).

# Get Person by UUID

## Get person by UUID

> Retrieves a single person by their internal UUID — the system-generated identifier assigned when the person was created. Returns the full person object including all standard fields and custom \`attribute\_values\`.\
> \
> Use this when you have the internal UUID rather than the external ID. The response format is identical to the external ID variant.<br>

```json
{"openapi":"3.0.3","info":{"title":"Listener API","version":"1.0.0"},"tags":[{"name":"get-person-by-uuid"}],"servers":[{"url":"https://{domain}/v1","variables":{"domain":{"default":"your-domain","description":"Your deployment domain"}}}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT token with the required scope for the endpoint. Pass via the `Authorization: Bearer <token>` header.\n"}},"parameters":{"PersonUuid":{"name":"uuid","in":"path","required":true,"description":"The internal UUID of the person.","schema":{"type":"string","format":"uuid"}}},"schemas":{"PersonResponse":{"type":"object","description":"Response envelope containing a person object.","properties":{"status":{"type":"string","enum":["Success"]},"data":{"$ref":"#/components/schemas/Person"}}},"Person":{"type":"object","description":"A person (contact) object.","properties":{"id":{"type":"string","format":"uuid","description":"Internal UUID."},"external_id":{"type":"string","description":"External identifier."},"first_name":{"type":"string"},"last_name":{"type":"string"},"email":{"type":"string","format":"email"},"mobile_prefix":{"type":"string"},"mobile_number":{"type":"string"},"date_of_birth":{"type":"string"},"language":{"type":"string"},"email_consent":{"type":"boolean"},"sms_consent":{"type":"boolean"},"push_notification_consent":{"type":"boolean"},"attribute_values":{"type":"object","additionalProperties":true}}},"ErrorResponse":{"type":"object","description":"Standard error response envelope.","properties":{"error":{"type":"string","description":"Machine-readable error type. Use this for programmatic error handling.\n","enum":["operation_failed","failed_binding_json","invalid_json","invalid_parameter","not_found","duplicate_entry","rate_limit_exceeded"]},"errorstack":{"type":"object","nullable":true,"description":"Detailed error stack (only present for server errors)."}}}}},"paths":{"/people/internal/{uuid}":{"get":{"summary":"Get person by UUID","operationId":"getPersonByUuid","tags":["get-person-by-uuid"],"description":"Retrieves a single person by their internal UUID — the system-generated identifier assigned when the person was created. Returns the full person object including all standard fields and custom `attribute_values`.\n\nUse this when you have the internal UUID rather than the external ID. The response format is identical to the external ID variant.\n","parameters":[{"$ref":"#/components/parameters/PersonUuid"}],"responses":{"200":{"description":"Person found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonResponse"}}}},"500":{"description":"Person not found or internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```