{
  "info": {
    "_postman_id": "32be0b95-58a1-499a-bfd4-fa7f94425587",
    "name": "Amplitude User Profile API",
    "description": "The Amplitude User Profile API serves user profiles that include user properties, computed user properties, a list of cohort IDs the user belongs to, and personalized recommendations. It enables real-time access to enriched user data for powering personalization engines, in-app experiences, and targeted content delivery. This API is particularly useful for retrieving recommendation results generated by Amplitude's machine learning models.\n\nContact Support:\n Name: Amplitude Support",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-06-05T15:05:32.000Z",
    "updatedAt": "2026-06-05T15:05:33.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-32be0b95-58a1-499a-bfd4-fa7f94425587"
  },
  "item": [
    {
      "name": "v1",
      "item": [
        {
          "name": "userprofile",
          "item": [
            {
              "name": "Amplitude Get a User Profile",
              "id": "1bdba3bd-c0c4-4bed-a611-f4e99e17481e",
              "protocolProfileBehavior": {
                "disableBodyPruning": true
              },
              "request": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/userprofile?user_id=<string>&comp_id=<integer>&get_recs=false&rec_id=<string>&rec_type=<string>&limit=<integer>",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "userprofile"
                  ],
                  "query": [
                    {
                      "description": "(Required) The user_id of the user whose profile to retrieve.",
                      "key": "user_id",
                      "value": "<string>"
                    },
                    {
                      "description": "The computed property ID or recommendation ID to retrieve specific computed results for the user.",
                      "key": "comp_id",
                      "value": "<integer>"
                    },
                    {
                      "description": "When true, include personalized recommendations in the response.",
                      "key": "get_recs",
                      "value": "false"
                    },
                    {
                      "description": "The recommendation model ID to retrieve specific recommendation results.",
                      "key": "rec_id",
                      "value": "<string>"
                    },
                    {
                      "description": "The type of recommendation to retrieve.",
                      "key": "rec_type",
                      "value": "<string>"
                    },
                    {
                      "description": "The maximum number of recommendation results to return.",
                      "key": "limit",
                      "value": "<integer>"
                    }
                  ]
                },
                "description": "Retrieve the profile for a specific user including user properties, computed properties, cohort memberships, and personalized recommendations. The response includes all enriched data Amplitude has computed for the user."
              },
              "response": [
                {
                  "id": "5a01c7a3-1be9-44be-a74b-9f8d71745971",
                  "name": "Success",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      },
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "Authorization",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/v1/userprofile?user_id=<string>&comp_id=<integer>&get_recs=false&rec_id=<string>&rec_type=<string>&limit=<integer>",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "userprofile"
                      ],
                      "query": [
                        {
                          "description": "(Required) The user_id of the user whose profile to retrieve.",
                          "key": "user_id",
                          "value": "<string>"
                        },
                        {
                          "description": "The computed property ID or recommendation ID to retrieve specific computed results for the user.",
                          "key": "comp_id",
                          "value": "<integer>"
                        },
                        {
                          "description": "When true, include personalized recommendations in the response.",
                          "key": "get_recs",
                          "value": "false"
                        },
                        {
                          "description": "The recommendation model ID to retrieve specific recommendation results.",
                          "key": "rec_id",
                          "value": "<string>"
                        },
                        {
                          "description": "The type of recommendation to retrieve.",
                          "key": "rec_type",
                          "value": "<string>"
                        },
                        {
                          "description": "The maximum number of recommendation results to return.",
                          "key": "limit",
                          "value": "<integer>"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"userData\": {\n    \"user_id\": \"<string>\",\n    \"user_properties\": {\n      \"consectetur_1_\": 50200227,\n      \"Duis__\": false\n    },\n    \"computed_properties\": {\n      \"eu_044\": \"aliqua occaecat adipisi\",\n      \"reprehenderit_05_\": -1012204.7621404529\n    },\n    \"cohort_ids\": [\n      \"<string>\",\n      \"<string>\"\n    ],\n    \"recommendations\": [\n      {\n        \"rec_id\": \"<string>\",\n        \"child_ids\": [\n          \"<string>\",\n          \"<string>\"\n        ],\n        \"is_control\": \"<boolean>\",\n        \"recommendation_type\": \"<string>\",\n        \"title\": \"<string>\"\n      },\n      {\n        \"rec_id\": \"<string>\",\n        \"child_ids\": [\n          \"<string>\",\n          \"<string>\"\n        ],\n        \"is_control\": \"<boolean>\",\n        \"recommendation_type\": \"<string>\",\n        \"title\": \"<string>\"\n      }\n    ],\n    \"amplitude_id\": \"<long>\"\n  }\n}",
                  "createdAt": "2026-06-05T15:05:33.000Z",
                  "updatedAt": "2026-06-05T15:05:33.000Z",
                  "uid": "35240-5a01c7a3-1be9-44be-a74b-9f8d71745971"
                },
                {
                  "id": "02126f0b-e602-4017-a75f-2da0a92bcac7",
                  "name": "Bad request - missing user_id",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "Authorization",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/v1/userprofile?user_id=<string>&comp_id=<integer>&get_recs=false&rec_id=<string>&rec_type=<string>&limit=<integer>",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "userprofile"
                      ],
                      "query": [
                        {
                          "description": "(Required) The user_id of the user whose profile to retrieve.",
                          "key": "user_id",
                          "value": "<string>"
                        },
                        {
                          "description": "The computed property ID or recommendation ID to retrieve specific computed results for the user.",
                          "key": "comp_id",
                          "value": "<integer>"
                        },
                        {
                          "description": "When true, include personalized recommendations in the response.",
                          "key": "get_recs",
                          "value": "false"
                        },
                        {
                          "description": "The recommendation model ID to retrieve specific recommendation results.",
                          "key": "rec_id",
                          "value": "<string>"
                        },
                        {
                          "description": "The type of recommendation to retrieve.",
                          "key": "rec_type",
                          "value": "<string>"
                        },
                        {
                          "description": "The maximum number of recommendation results to return.",
                          "key": "limit",
                          "value": "<integer>"
                        }
                      ]
                    }
                  },
                  "status": "Bad Request",
                  "code": 400,
                  "_postman_previewlanguage": "text",
                  "header": [],
                  "cookie": [],
                  "responseTime": null,
                  "body": null,
                  "createdAt": "2026-06-05T15:05:33.000Z",
                  "updatedAt": "2026-06-05T15:05:33.000Z",
                  "uid": "35240-02126f0b-e602-4017-a75f-2da0a92bcac7"
                },
                {
                  "id": "b74fd1d6-e3d3-40d6-968c-ed9535417a09",
                  "name": "Unauthorized - invalid or missing API key",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "Authorization",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/v1/userprofile?user_id=<string>&comp_id=<integer>&get_recs=false&rec_id=<string>&rec_type=<string>&limit=<integer>",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "userprofile"
                      ],
                      "query": [
                        {
                          "description": "(Required) The user_id of the user whose profile to retrieve.",
                          "key": "user_id",
                          "value": "<string>"
                        },
                        {
                          "description": "The computed property ID or recommendation ID to retrieve specific computed results for the user.",
                          "key": "comp_id",
                          "value": "<integer>"
                        },
                        {
                          "description": "When true, include personalized recommendations in the response.",
                          "key": "get_recs",
                          "value": "false"
                        },
                        {
                          "description": "The recommendation model ID to retrieve specific recommendation results.",
                          "key": "rec_id",
                          "value": "<string>"
                        },
                        {
                          "description": "The type of recommendation to retrieve.",
                          "key": "rec_type",
                          "value": "<string>"
                        },
                        {
                          "description": "The maximum number of recommendation results to return.",
                          "key": "limit",
                          "value": "<integer>"
                        }
                      ]
                    }
                  },
                  "status": "Unauthorized",
                  "code": 401,
                  "_postman_previewlanguage": "text",
                  "header": [],
                  "cookie": [],
                  "responseTime": null,
                  "body": null,
                  "createdAt": "2026-06-05T15:05:33.000Z",
                  "updatedAt": "2026-06-05T15:05:33.000Z",
                  "uid": "35240-b74fd1d6-e3d3-40d6-968c-ed9535417a09"
                },
                {
                  "id": "49b2e3f0-b177-47e6-840a-c86b0535b286",
                  "name": "User not found",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "Authorization",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/v1/userprofile?user_id=<string>&comp_id=<integer>&get_recs=false&rec_id=<string>&rec_type=<string>&limit=<integer>",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "userprofile"
                      ],
                      "query": [
                        {
                          "description": "(Required) The user_id of the user whose profile to retrieve.",
                          "key": "user_id",
                          "value": "<string>"
                        },
                        {
                          "description": "The computed property ID or recommendation ID to retrieve specific computed results for the user.",
                          "key": "comp_id",
                          "value": "<integer>"
                        },
                        {
                          "description": "When true, include personalized recommendations in the response.",
                          "key": "get_recs",
                          "value": "false"
                        },
                        {
                          "description": "The recommendation model ID to retrieve specific recommendation results.",
                          "key": "rec_id",
                          "value": "<string>"
                        },
                        {
                          "description": "The type of recommendation to retrieve.",
                          "key": "rec_type",
                          "value": "<string>"
                        },
                        {
                          "description": "The maximum number of recommendation results to return.",
                          "key": "limit",
                          "value": "<integer>"
                        }
                      ]
                    }
                  },
                  "status": "Not Found",
                  "code": 404,
                  "_postman_previewlanguage": "text",
                  "header": [],
                  "cookie": [],
                  "responseTime": null,
                  "body": null,
                  "createdAt": "2026-06-05T15:05:33.000Z",
                  "updatedAt": "2026-06-05T15:05:33.000Z",
                  "uid": "35240-49b2e3f0-b177-47e6-840a-c86b0535b286"
                }
              ],
              "createdAt": "2026-06-05T15:05:33.000Z",
              "updatedAt": "2026-06-05T15:05:33.000Z",
              "uid": "35240-1bdba3bd-c0c4-4bed-a611-f4e99e17481e"
            }
          ],
          "id": "7fc167ad-d162-421c-afb1-dc907fd2d5aa",
          "createdAt": "2026-06-05T15:05:33.000Z",
          "updatedAt": "2026-06-05T15:05:33.000Z",
          "uid": "35240-7fc167ad-d162-421c-afb1-dc907fd2d5aa"
        }
      ],
      "id": "108c81df-d165-45b0-aa10-9699eb885801",
      "createdAt": "2026-06-05T15:05:33.000Z",
      "updatedAt": "2026-06-05T15:05:33.000Z",
      "uid": "35240-108c81df-d165-45b0-aa10-9699eb885801"
    }
  ],
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "Authorization",
        "type": "string"
      },
      {
        "key": "value",
        "value": "{{apiKey}}",
        "type": "string"
      },
      {
        "key": "in",
        "value": "header",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://profile-api.amplitude.com"
    }
  ]
}