{
  "opencollection": "1.0.0",
  "info": {
    "name": "Surfe Account People API",
    "version": "2.0"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "People",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Search people",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.surfe.com/v2/people/search",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Search for people by persona filters (job titles, seniorities, departments) and company filters (industry, headcount, location). Job titles are expanded automatically with acronym and semantic matching. Results are paged with nextPageToken."
        },
        {
          "info": {
            "name": "Enrich people (start)",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.surfe.com/v2/people/enrich",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Start an asynchronous bulk enrichment job for up to 10,000 people. Each person is identified by a LinkedIn URL, or by first name + last name + company name or domain. Returns an enrichment ID for polling or a webhook callback."
        },
        {
          "info": {
            "name": "Enrich people (get)",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.surfe.com/v2/people/enrich/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The enrichment job ID returned by the start operation."
              }
            ]
          },
          "docs": "Retrieve the status and results of a people enrichment job by ID. Poll until status is COMPLETED, or use a webhook to be notified."
        },
        {
          "info": {
            "name": "Find people by email",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.surfe.com/v2/people/find-by-email",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Enrich people directly from a list of email addresses, returning the matched person profile and firmographics where available."
        }
      ]
    }
  ],
  "bundled": true
}