Skip to main content
GET
Look up a protein
Look up one protein by UniProt accession, entry name, gene symbol, or exact protein name. The response gives its curated subcellular location, function, and GO cellular-component terms from UniProtKB/Swiss-Prot, the reviewed section of UniProtKB. Each statement carries its evidence kind and, where UniProt cites one, a pmid: paper id in the form GET /search/research/papers/{id} accepts. A GO term’s paperIds can be empty, and only GO terms of human entries have paper ids. match says how the lookup resolved:
  • found: one entry matched, and protein holds its annotation.
  • ambiguous: the identifier names more than one entry, or matched only outside the requested organism. candidates lists up to 10 entries. Call again with one candidate’s accession.
  • not_found: no entry matches. This is a 200, not a 404.
Protein data from UniProtKB/Swiss-Prot. Copyright UniProt Consortium. Licensed under CC BY 4.0. No warranty, see the UniProt license. Selected fields, reformatted. Every 200 response repeats this in notice and names the UniProt release in release. For the resolution rules and the evidence kinds, see the Research Index guide.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

protein
string
required

One protein identifier, 1 to 200 characters after trimming: a UniProt accession (Q6P087, or Q6P087-2 for an isoform), an entry name (RUSD3_HUMAN), a gene symbol (RPUSD3), or an exact protein name (Mitochondrial mRNA pseudouridine synthase RPUSD3).

Required string length: 1 - 200
organism
string
default:9606

Organism that scopes a gene symbol or protein name: an NCBI taxon id (9606), a scientific name (Homo sapiens), or a UniProt common name (Human), matched without regard to case. Accessions and entry names ignore it.

Minimum string length: 1

Response

Lookup result. match is found, ambiguous, or not_found. A protein that matches no entry is a 200 with match: "not_found", not a 404.

success
boolean
required
release
string
required

UniProt release the lookup reads, such as 2026_04.

match
enum<string>
required
Available options:
found
protein
object
required
notice
string
required

Attribution and license notice for the UniProt data.