API Reference

Base URLs

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key from the Reprompt Dashboard.

Enrichment

Enrich a single place synchronously

POST /place_enrichment/enrich

Enrich a single place with specified attributes. Returns results synchronously.

curl -X POST \
  'https://api.repromptai.com/v1/{org_slug}/place_enrichment/enrich' \
  -H 'Authorization: Bearer {YOUR_API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
    "inputs": {
      "place_id": "my_place_123",
      "name": "Joe'\''s Pizza",
      "latitude": 40.7359,
      "longitude": -73.9911
    },
    "attributes": ["websites", "phoneNumbers"]
  }'

import requests

response = requests.post(
    "https://api.repromptai.com/v1/{org_slug}/place_enrichment/enrich",
    headers={"Authorization": "Bearer {YOUR_API_KEY}"},
    json={
        "inputs": {
            "place_id": "my_place_123",
            "name": "Joes Pizza",
            "latitude": 40.7359,
            "longitude": -73.9911
        },
        "attributes": ["websites", "phoneNumbers"]
    }
)
print(response.json())

const response = await fetch(
  'https://api.repromptai.com/v1/{org_slug}/place_enrichment/enrich',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer {YOUR_API_KEY}',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      inputs: {
        place_id: "my_place_123",
        name: "Joes Pizza",
        latitude: 40.7359,
        longitude: -73.9911
      },
      attributes: ["websites", "phoneNumbers"]
    })
  }
);
console.log(await response.json());

Attributes

Get all available attributes

GET /place_enrichment/attributes

Returns the complete list of enrichment attributes available for your organization.

curl 'https://api.repromptai.com/v1/{org_slug}/place_enrichment/attributes' \
  -H 'Authorization: Bearer {YOUR_API_KEY}'

Jobs

Submit a single enrichment job

POST /place_enrichment/jobs

Submit a single place for asynchronous enrichment.

Get enrichment jobs

GET /place_enrichment/jobs

Retrieve enrichment job results. Supports filtering by batchId, status, and pagination via limit/offset.

Get a single enrichment job

GET /place_enrichment/jobs/{place_id}

Retrieve the enrichment result for a specific place.

Delete a job

DELETE /place_enrichment/jobs/{place_id}

Delete a specific enrichment job.

Reprocess jobs

POST /place_enrichment/jobs/reprocess

Re-queue jobs for enrichment with optional attribute overrides.

Batches

Submit a batch

POST /place_enrichment/batches

Submit multiple places for asynchronous enrichment. Maximum 50,000 places per request.

curl -X POST \
  'https://api.repromptai.com/v1/{org_slug}/place_enrichment/batches' \
  -H 'Authorization: Bearer {YOUR_API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
    "batch_name": "My Batch",
    "attributes": ["websites", "phoneNumbers"],
    "jobs": [
      {
        "place_id": "store_001",
        "inputs": {
          "name": "Downtown Store",
          "full_address": "123 Main St, New York, NY 10001"
        }
      }
    ]
  }'

List batches

GET /place_enrichment/batches

List all batches with pagination.

Get batch status

GET /place_enrichment/batches/{batch_id}

Get the current status of a batch including job status counts.

Delete a batch

DELETE /place_enrichment/batches/{batch_id}

Delete a batch and all its jobs.

Reprocess a batch

POST /place_enrichment/batches/{batch_id}/reprocess

Re-queue jobs in a batch for enrichment.

Mark batches for refresh

POST /place_enrichment/batches/refresh

Mark batches for inclusion in the monthly refresh cycle.

OpenAPI Specification

Download the full OpenAPI specifications:

• V1 OpenAPI Spec
• V2 OpenAPI Spec
• KYB OpenAPI Spec