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

# People

## GET /people/

>

```json
{"openapi":"3.0.1","info":{"title":"Relabase Public API","version":"v1"},"servers":[{"url":"api.rekap.com/relabase/api/v1/public"}],"security":[{"Bearer":[]},{"Token":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","description":"Authenticate using `Bearer <jwt>` format for internal endpoints","name":"Authorization","in":"header"},"Token":{"type":"apiKey","description":"Authenticate using `Token <key>` format","name":"Authorization","in":"header"}},"schemas":{"PublicPersonSummary":{"type":"object","properties":{"id":{"title":"ID","type":"integer","readOnly":true},"uuid":{"title":"Uuid","type":"string","format":"uuid","readOnly":true},"name":{"title":"Name","minLength":1,"type":"string","readOnly":true},"first_name":{"title":"First name","minLength":1,"type":"string","readOnly":true},"last_name":{"title":"Last name","minLength":1,"type":"string","readOnly":true},"preferred_name":{"title":"Preferred name","minLength":1,"type":"string","nullable":true,"readOnly":true},"linkedin_url":{"title":"Linkedin url","minLength":1,"type":"string","format":"uri","nullable":true,"readOnly":true},"phone":{"title":"Phone","minLength":1,"type":"string","nullable":true,"readOnly":true},"primary_work_email":{"title":"Primary work email","type":"string","nullable":true,"readOnly":true},"primary_personal_email":{"title":"Primary personal email","type":"string","nullable":true,"readOnly":true},"archived":{"title":"Archived","type":"string","format":"date-time","nullable":true,"readOnly":true},"created":{"title":"Created","type":"string","format":"date-time","readOnly":true},"modified":{"title":"Modified","type":"string","format":"date-time","readOnly":true}}}}},"paths":{"/people/":{"get":{"tags":["people"],"operationId":"people_list","parameters":[{"name":"search","in":"query","description":"A search term.","schema":{"type":"string"}},{"name":"ordering","in":"query","description":"Which field to use when ordering the results.","schema":{"type":"string"}},{"name":"page","in":"query","description":"Page number to retrieve (1-indexed).","schema":{"type":"integer"}},{"name":"page_size","in":"query","description":"Number of results per page. Defaults to the pagination class's page size and respects the configured maximum.","schema":{"type":"integer"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"required":["count","results"],"type":"object","properties":{"count":{"type":"integer"},"next":{"type":"string","format":"uri","nullable":true},"previous":{"type":"string","format":"uri","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/PublicPersonSummary"}}}}}}}}}}}}
```

## POST /people/

>

```json
{"openapi":"3.0.1","info":{"title":"Relabase Public API","version":"v1"},"servers":[{"url":"api.rekap.com/relabase/api/v1/public"}],"security":[{"Bearer":[]},{"Token":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","description":"Authenticate using `Bearer <jwt>` format for internal endpoints","name":"Authorization","in":"header"},"Token":{"type":"apiKey","description":"Authenticate using `Token <key>` format","name":"Authorization","in":"header"}},"schemas":{"PublicCreatePerson":{"required":["email"],"type":"object","properties":{"email":{"title":"Email","minLength":1,"type":"string","format":"email"},"display_name":{"title":"Display name","type":"string","nullable":true},"first_name":{"title":"First name","type":"string","nullable":true},"last_name":{"title":"Last name","type":"string","nullable":true},"phone":{"title":"Phone","type":"string","nullable":true},"linkedin_url":{"title":"Linkedin url","type":"string","nullable":true},"website":{"title":"Website","type":"string","nullable":true},"company":{"title":"Company","type":"string","nullable":true},"job_title":{"title":"Job title","type":"string","nullable":true},"industry":{"title":"Industry","type":"string","nullable":true},"address":{"title":"Address","type":"string","nullable":true},"city":{"title":"City","type":"string","nullable":true},"state":{"title":"State","type":"string","nullable":true},"postal_code":{"title":"Postal code","type":"string","nullable":true},"country":{"title":"Country","type":"string","nullable":true},"slack_member_id":{"title":"Slack member id","type":"string","nullable":true}}}}},"paths":{"/people/":{"post":{"tags":["people"],"operationId":"people_create","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCreatePerson"}}},"required":true},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCreatePerson"}}}}}}}}}
```

## GET /people/{id}/

>

```json
{"openapi":"3.0.1","info":{"title":"Relabase Public API","version":"v1"},"servers":[{"url":"api.rekap.com/relabase/api/v1/public"}],"security":[{"Bearer":[]},{"Token":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","description":"Authenticate using `Bearer <jwt>` format for internal endpoints","name":"Authorization","in":"header"},"Token":{"type":"apiKey","description":"Authenticate using `Token <key>` format","name":"Authorization","in":"header"}},"schemas":{"PublicPersonDetail":{"type":"object","properties":{"id":{"title":"ID","type":"integer","readOnly":true},"uuid":{"title":"Uuid","type":"string","format":"uuid","readOnly":true},"name":{"title":"Name","minLength":1,"type":"string","readOnly":true},"first_name":{"title":"First name","minLength":1,"type":"string","readOnly":true},"last_name":{"title":"Last name","minLength":1,"type":"string","readOnly":true},"preferred_name":{"title":"Preferred name","minLength":1,"type":"string","nullable":true,"readOnly":true},"linkedin_url":{"title":"Linkedin url","minLength":1,"type":"string","format":"uri","nullable":true,"readOnly":true},"phone":{"title":"Phone","minLength":1,"type":"string","nullable":true,"readOnly":true},"primary_work_email":{"title":"Primary work email","type":"string","nullable":true,"readOnly":true},"primary_personal_email":{"title":"Primary personal email","type":"string","nullable":true,"readOnly":true},"archived":{"title":"Archived","type":"string","format":"date-time","nullable":true,"readOnly":true},"created":{"title":"Created","type":"string","format":"date-time","readOnly":true},"modified":{"title":"Modified","type":"string","format":"date-time","readOnly":true},"emails":{"type":"array","readOnly":true,"items":{"$ref":"#/components/schemas/PublicPersonEmail"}},"addresses":{"type":"array","readOnly":true,"items":{"$ref":"#/components/schemas/PublicPersonAddress"}},"roles":{"type":"array","readOnly":true,"items":{"$ref":"#/components/schemas/PublicRoleSummary"}}}},"PublicPersonEmail":{"type":"object","properties":{"id":{"title":"ID","type":"integer","readOnly":true},"name":{"title":"Name","minLength":1,"type":"string","readOnly":true},"is_primary":{"title":"Is primary","type":"boolean","readOnly":true},"is_work":{"title":"Is work","type":"boolean","readOnly":true},"role_id":{"title":"Role id","type":"integer","readOnly":true},"created":{"title":"Created","type":"string","format":"date-time","readOnly":true},"modified":{"title":"Modified","type":"string","format":"date-time","readOnly":true}}},"PublicPersonAddress":{"type":"object","properties":{"id":{"title":"ID","type":"integer","readOnly":true},"street_address":{"title":"Street address","minLength":1,"type":"string","nullable":true,"readOnly":true},"city":{"title":"City","minLength":1,"type":"string","nullable":true,"readOnly":true},"state":{"title":"State","minLength":1,"type":"string","nullable":true,"readOnly":true},"country":{"title":"Country","minLength":1,"type":"string","nullable":true,"readOnly":true},"postal_code":{"title":"Postal code","minLength":1,"type":"string","nullable":true,"readOnly":true}}},"PublicRoleSummary":{"type":"object","properties":{"id":{"title":"ID","type":"integer","readOnly":true},"uuid":{"title":"Uuid","type":"string","format":"uuid","readOnly":true},"title":{"title":"Title","minLength":1,"type":"string","readOnly":true},"organization":{"$ref":"#/components/schemas/PublicOrganizationSummary"},"start_date":{"title":"Start date","type":"string","format":"date","readOnly":true},"end_date":{"title":"End date","type":"string","format":"date","nullable":true,"readOnly":true},"is_primary":{"title":"Is primary","type":"boolean","readOnly":true},"role_type":{"title":"Role type","type":"string","readOnly":true,"enum":["employee","contractor","candidate","contact"]}}},"PublicOrganizationSummary":{"type":"object","properties":{"id":{"title":"ID","type":"integer","readOnly":true},"uuid":{"title":"Uuid","type":"string","format":"uuid","readOnly":true},"name":{"title":"Name","minLength":1,"type":"string","readOnly":true},"type":{"title":"Type","minLength":1,"type":"string","readOnly":true},"archived":{"title":"Archived","type":"string","format":"date-time","nullable":true,"readOnly":true}}}}},"paths":{"/people/{id}/":{"get":{"tags":["people"],"operationId":"people_read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPersonDetail"}}}}}}}}}
```