v43

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-0520621.8 MB

Get best email addresses by GitHub node IDs

Fetch the best email address for GitHub users by their node IDs. Uses intelligent selection to prioritize personal emails over work emails and verifies domain validity. Returns the best email plus all other email candidates. Supports batch requests (1-100 IDs). Requires RAW service. Credits: 1 per result returned.

post/users/best-email

Request body

githubIdsstring[] required

Array of GitHub node IDs (1-100)

Example request

{
  "githubIds": [
    "MDQ6VXNlcjU4MzIzMQ==",
    "MDQ6VXNlcjE="
  ]
}

Response

Best emails retrieved successfully

countnumber required

Number of results returned

Example response

{
  "results": [
    {
      "githubId": "MDQ6VXNlcjU4MzIzMQ==",
      "login": "octocat",
      "bestEmail": "octocat@gmail.com",
      "otherCandidates": [],
      "profile": "WORK"
    }
  ],
  "count": 2
}