# User

Search for keys by user name or service.

WARNING

If you use these search results directly, you are trusting the keys.pub server. It is recommended to use this API to find a key and then to verify the user statement in the key's sigchain yourself. For details on how to verify sigchains and users see User#Verify.

Request Description
q Query.
limit Limit number of results.
curl https://keys.pub/user/search?q=gabriel
{
  "users": [
    {
      "id": "gabriel@github",
      "name": "gabriel",
      "kid": "kex1mnseg28xu6g3j4wur7hqwk8ag3fu3pmr2t5lync26xmgff0dtryqupf80c",
      "seq": 1,
      "service": "github",
      "url": "https://gist.github.com/gabriel/ceea0f3b675bac03425472692273cf52",
      "status": "ok",
      "verifiedAt": 1581680761310
    }
  ]
}

# GET /user/:kid

Get user for key.

curl https://keys.pub/user/kex1mnseg28xu6g3j4wur7hqwk8ag3fu3pmr2t5lync26xmgff0dtryqupf80c
{
  "user": {
    "id": "gabriel@github",
    "name": "gabriel",
    "kid": "kex1mnseg28xu6g3j4wur7hqwk8ag3fu3pmr2t5lync26xmgff0dtryqupf80c",
    "seq": 1,
    "service": "github",
    "url": "https://gist.github.com/gabriel/ceea0f3b675bac03425472692273cf52",
    "status": "ok",
    "verifiedAt": 1582097462744
  }
}