Skip to main content
POST
/
v1
/
humanizations
/
batch
Batch-submit humanization jobs
curl --request POST \
  --url https://api.example.com/v1/humanizations/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "variant_id": "11112222-3333-4444-5555-666677778888"
    }
  ]
}
'
{
  "items": [
    {
      "completed_at": "2026-04-22T14:15:28+00:00",
      "created_at": "2026-04-22T14:15:00+00:00",
      "credit_cost": 1,
      "id": "dddd1111-eeee-2222-ffff-333344445555",
      "inputs": {
        "variant_id": "11112222-3333-4444-5555-666677778888"
      },
      "object": "humanization",
      "results": [
        {
          "humanized_vh": "EVQLVESGGGLVQPGGSLRLSCAAS...",
          "humanized_vl": "DIQMTQSPSSLSASVGDRVTITCRASQ...",
          "liabilities": {
            "glycosylation": [],
            "oxidation": [
              "H100"
            ]
          },
          "mutations": {
            "vh": 12,
            "vl": 8
          },
          "oasis_score": {
            "mean": 0.91,
            "median": 0.93
          },
          "strategy": "cdr_grafting"
        }
      ],
      "started_at": "2026-04-22T14:15:02+00:00",
      "status": "completed"
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Body

application/json

Body for POST /v1/humanizations/batch.

items
HumanizationSubmit · object[]
required

One to 50 humanization submit payloads.

Required array length: 1 - 50 elements

Response

Successful Response

Response for POST /v1/humanizations/batch.

items
Humanization · object[]
required