Persons API Reference

Persons

For instructions on how to authenticate to use this endpoint, see API overview.

Endpoints

`GET`	`/api/projects/:project_id/persons/`
`POST`	`/api/projects/:project_id/persons/`
`GET`	`/api/projects/:project_id/persons/:id/`
`PATCH`	`/api/projects/:project_id/persons/:id/`
`DELETE`	`/api/projects/:project_id/persons/:id/`
`GET`	`/api/projects/:project_id/persons/:id/activity/`
`POST`	`/api/projects/:project_id/persons/:id/delete_property/`
`POST`	`/api/projects/:project_id/persons/:id/merge/`
`POST`	`/api/projects/:project_id/persons/:id/split/`
`GET`	`/api/projects/:project_id/persons/activity/`
`GET`	`/api/projects/:project_id/persons/cohorts/`
`GET`	`/api/projects/:project_id/persons/funnel/`
`POST`	`/api/projects/:project_id/persons/funnel/`
`GET`	`/api/projects/:project_id/persons/funnel/correlation/`
`POST`	`/api/projects/:project_id/persons/funnel/correlation/`
`GET`	`/api/projects/:project_id/persons/lifecycle/`
`GET`	`/api/projects/:project_id/persons/path/`
`POST`	`/api/projects/:project_id/persons/path/`
`GET`	`/api/projects/:project_id/persons/properties/`
`GET`	`/api/projects/:project_id/persons/retention/`
`GET`	`/api/projects/:project_id/persons/stickiness/`
`GET`	`/api/projects/:project_id/persons/values/`

List all persons

Path Parameters

project_id
string

Query Parameters

distinct_id
integer
email
string
format
string
One of: "csv""json"
limit
integer
offset
integer
properties
array
search
string

Response

Request

GET /api/projects/:project_id/persons/

Response

{
  "next": "https://app.posthog.com/api/projects/{project_id}/accounts/?offset=400&limit=100",
  "previous": "https://app.posthog.com/api/projects/{project_id}/accounts/?offset=400&limit=100",
  "results": [
    {
      "id": 0,
      "name": "string",
      "distinct_ids": [
        "string"
      ],
      "properties": {
        "property1": null,
        "property2": null
      },
      "created_at": "2019-08-24T14:15:22Z",
      "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
    }
  ]
}

Create persons

Path Parameters

project_id
string

Query Parameters

format
string
One of: "csv""json"

Request Parameters

properties
object

Response

Request

POST /api/projects/:project_id/persons/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Retrieve persons

Path Parameters

id
integer
project_id
string

Query Parameters

format
string
One of: "csv""json"

Response

Request

GET /api/projects/:project_id/persons/:id/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Update persons

Path Parameters

id
integer
project_id
string

Query Parameters

format
string
One of: "csv""json"

Request Parameters

properties
object

Response

Request

PATCH /api/projects/:project_id/persons/:id/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Delete persons

Path Parameters

id
integer
project_id
string

Query Parameters

format
string
One of: "csv""json"

Request

DELETE /api/projects/:project_id/persons/:id/

Response

No response

Retrieve persons activity retrieve

Path Parameters

id
integer
project_id
string

Query Parameters

format
string
One of: "csv""json"

Response

Request

GET /api/projects/:project_id/persons/:id/activity/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Create persons delete property

Path Parameters

id
integer
project_id
string

Query Parameters

format
string
One of: "csv""json"

Request Parameters

properties
object

Response

Request

POST /api/projects/:project_id/persons/:id/delete_property/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Create persons merge

Path Parameters

id
integer
project_id
string

Query Parameters

format
string
One of: "csv""json"

Request Parameters

properties
object

Response

Request

POST /api/projects/:project_id/persons/:id/merge/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Create persons split

Path Parameters

id
integer
project_id
string

Query Parameters

format
string
One of: "csv""json"

Request Parameters

properties
object

Response

Request

POST /api/projects/:project_id/persons/:id/split/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Retrieve persons activity

Path Parameters

project_id
string

Query Parameters

format
string
One of: "csv""json"

Response

Request

GET /api/projects/:project_id/persons/activity/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Retrieve persons cohorts

Path Parameters

project_id
string

Query Parameters

format
string
One of: "csv""json"

Response

Request

GET /api/projects/:project_id/persons/cohorts/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Retrieve persons funnel

Path Parameters

project_id
string

Query Parameters

format
string
One of: "csv""json"

Response

Request

GET /api/projects/:project_id/persons/funnel/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Create persons funnel

Path Parameters

project_id
string

Query Parameters

format
string
One of: "csv""json"

Request Parameters

properties
object

Response

Request

POST /api/projects/:project_id/persons/funnel/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Retrieve persons funnel correlation

Path Parameters

project_id
string

Query Parameters

format
string
One of: "csv""json"

Response

Request

GET /api/projects/:project_id/persons/funnel/correlation/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Create persons funnel correlation

Path Parameters

project_id
string

Query Parameters

format
string
One of: "csv""json"

Request Parameters

properties
object

Response

Request

POST /api/projects/:project_id/persons/funnel/correlation/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Retrieve persons lifecycle

Path Parameters

project_id
string

Query Parameters

format
string
One of: "csv""json"

Response

Request

GET /api/projects/:project_id/persons/lifecycle/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Retrieve persons path

Path Parameters

project_id
string

Query Parameters

format
string
One of: "csv""json"

Response

Request

GET /api/projects/:project_id/persons/path/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Create persons path

Path Parameters

project_id
string

Query Parameters

format
string
One of: "csv""json"

Request Parameters

properties
object

Response

Request

POST /api/projects/:project_id/persons/path/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Retrieve persons properties

Path Parameters

project_id
string

Query Parameters

format
string
One of: "csv""json"

Response

Request

GET /api/projects/:project_id/persons/properties/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Retrieve persons retention

Path Parameters

project_id
string

Query Parameters

format
string
One of: "csv""json"

Response

Request

GET /api/projects/:project_id/persons/retention/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Retrieve persons stickiness

Path Parameters

project_id
string

Query Parameters

format
string
One of: "csv""json"

Response

Request

GET /api/projects/:project_id/persons/stickiness/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Retrieve persons values

Path Parameters

project_id
string

Query Parameters

format
string
One of: "csv""json"

Response

Request

GET /api/projects/:project_id/persons/values/

Response

{
  "id": 0,
  "name": "string",
  "distinct_ids": [
    "string"
  ],
  "properties": {
    "property1": null,
    "property2": null
  },
  "created_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}