Developer API / docs

Detect Indian PII API

Scan text for 18 Indian identifier types (Aadhaar with checksum, PAN, GSTIN, UPI, IFSC, phone, voter ID and more). The JSON report gives positions, validity, confidence and a masked stand-in - it never repeats the raw identifier.

POSThttps://api.gigai.tools/v1/jobsAsync

Runs as the detect-pii operation inside a job. Needs a key with the jobs:write scope.

Options

types - string
require_valid - boolean

Limits

Input: txt, md, csv, json, html (one file, checked by content, never by extension).
Max input size: 10 MB.
Output: json.
Time budget: 60 seconds, then the task fails with the timeout code.
Engine: indian-pii.

Inside a bigger job

Chain it: any task can consume this one's output by naming it in input. The recipes show working pipelines.

as one task in a graph

"step": { "operation": "detect-pii", "input": ["previous-task"] }

Errors this tool returns

invalid_input, invalid_option, file_too_large, timeout. The full list with fixes is on the errors page.

Redact Indian PII

Was this page helpful?

curl -X POST https://api.gigai.tools/v1/jobs \
  -H "Authorization: Bearer $GIGAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tasks": {
    "in": { "operation": "import/url", "url": "https://example.com/input.txt" },
    "work": { "operation": "detect-pii", "input": ["in"] },
    "out": { "operation": "export/url", "input": ["work"] }
  } }'

# then poll until finished and follow the export URL:
curl https://api.gigai.tools/v1/jobs/JOB_ID/wait -H "Authorization: Bearer $GIGAI_API_KEY"

Finished job

{
  "id": "job_27b562f72d84a9a52324ced8",
  "status": "finished",
  "retention_s": 3600,
  "tasks": [
    { "name": "work", "operation": "detect-pii",
      "status": "finished", "duration_ms": 47 },
    { "name": "out", "operation": "export/url", "status": "finished",
      "result": { "files": [
        { "id": "file_63930500160eadd44dee99f1",
          "filename": "result.json", "size": 10420,
          "url": "https://api.gigai.tools/v1/files/file_639.../download?e=...&s=..." }
      ]}}
  ]
}

Detect Indian PII API

Options

Limits

Inside a bigger job

Errors this tool returns

Related tools