> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Protein Function
> Look up a protein’s function, literature citations, organism, cellular locations and catalytic activities by accession.
Protein annotations from UniProt under CC BY 4.0, attributed to the UniProt Consortium. Covers reviewed and unreviewed UniProtKB entries. Function texts retain their literature citations, with deduplicated PubMed identifiers also returned separately. Includes names, genes, organism, length, subcellular locations, catalytic activities, EC numbers, keywords and annotation score. UniProt releases updates every eight weeks; last\_updated is the entry’s last annotation date. The amino-acid sequence is returned only when include\_sequence is true, otherwise null. Absent values and collections are null. A merged accession resolves to its primary entry. A deleted or demerged accession returns no protein and the source’s structured inactive reason, including replacement accessions when supplied. No match returns null for both.
## Authentication
Requires x402 payment in the `payment-signature` header.
## Request Body
The UniProt accession identifying the protein, for example P04637.
Include the amino-acid sequence. Defaults to `false`.
## Response (200 OK)
Top-level envelope: `success` (boolean) and `data` (object). All fields below are nested under `data`.
Durable job ID for audit and lookup
Job status: `completed`
Always `protein_function`
The answer, described under Result below
Where the answer came from and when
The public body the data comes from. Always `UniProt Consortium`.
`public` when the data comes from a public body, `commercial` otherwise
When the lookup was made, as an ISO 8601 UTC time
When the source says the fact was last updated, or `null` when the source gives no date
## Result
Nested under `data.result`.
Protein. `null` when the source gives no value.
Accession. `null` when the source gives no value.
Entry name. `null` when the source gives no value.
Reviewed. `null` when the source gives no value.
Protein name. `null` when the source gives no value.
Alternative names. `null` when the source gives no value.
Genes. `null` when the source gives no value.
Name. `null` when the source gives no value.
Synonyms. `null` when the source gives no value.
Organism. `null` when the source gives no value.
Scientific name. `null` when the source gives no value.
Taxon id. `null` when the source gives no value.
Length. `null` when the source gives no value.
FUNCTION comment texts, retaining the source’s literature citations. `null` when the source gives no value.
Distinct PubMed identifiers from FUNCTION text evidences. `null` when the source gives no value.
Subcellular locations. `null` when the source gives no value.
Location. `null` when the source gives no value.
Isoform. `null` when the source gives no value.
Catalytic activities. `null` when the source gives no value.
Reaction. `null` when the source gives no value.
Ec. `null` when the source gives no value.
Ec numbers. `null` when the source gives no value.
Keywords. `null` when the source gives no value.
Id. `null` when the source gives no value.
Category. `null` when the source gives no value.
Name. `null` when the source gives no value.
Annotation score. `null` when the source gives no value.
Last annotation update date, YYYY-MM-DD. `null` when the source gives no value.
Amino-acid sequence, only when requested. `null` when the source gives no value.
Inactive reason. `null` when the source gives no value.
The source’s reason for inactivation, for example DELETED or DEMERGED. `null` when the source gives no value.
Replacement accessions for a demerged entry. `null` when the source gives no value.
```bash cURL theme={null}
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/protein-function \
-H "Content-Type: application/json" \
-H "payment-signature: " \
-d '{
"accession": "P29358",
"include_sequence": false
}'
```
```javascript JavaScript theme={null}
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/protein-function", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"accession": "P29358",
"include_sequence": false
}),
});
```
```typescript SDK theme={null}
const result = await agent.tool('lookup/protein-function', {
accession: 'P29358',
include_sequence: false
});
console.log(result.data.result);
console.log(result.data.evidence);
```
```json Response (200) theme={null}
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "protein_function",
"result": {
"protein": null,
"inactive_reason": {
"reason_type": "DEMERGED",
"replacement_accessions": [
"P68251",
"P68250"
]
}
},
"evidence": {
"source": "UniProt Consortium",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-01-15T12:00:00.000Z"
}
],
"as_of": null
}
}
}
```
See [Pricing](/pricing) for this tool's price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers `200`.
## Notes
* Results return inline. The finished job stays available at `/v1/requests/{request_id}`
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.