curl -X POST "https://app.lance.so/api/v1/operations/enrichment/bulk" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "selection": {
      "mode": "manual",
      "includedIds": [
        "550e8400-e29b-41d4-a716-446655440001",
        "550e8400-e29b-41d4-a716-446655440002"
      ]
    },
    "field": "emails"
  }'

const response = await fetch("/api/v1/operations/enrichment/bulk", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    selection: {
      mode: "manual",
      includedIds: [
        "550e8400-e29b-41d4-a716-446655440001",
        "550e8400-e29b-41d4-a716-446655440002",
      ],
    },
    field: "emails",
  }),
});

const enrichments = await response.json();

interface Enrichment {
  id: string;
  createdAt: string;
  updatedAt: string;
  entityId: string;
  entityType: "person" | "company" | "leadlist";
  field: string;
  status: "pending" | "finished" | "failed" | "timeout" | "cancelled";
  error: string | null;
  createdBy: string;
  orgId: string;
  globalEnrichmentId: string | null;
  creditTransactionId: string | null;
  dataFound: boolean | null;
}

const response = await fetch("/api/v1/operations/enrichment/bulk", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    selection: {
      mode: "bulk",
      startIndex: 0,
      targetCount: 50,
      filters: {
        job_title: ["CEO", "Founder"],
      },
    },
    field: "phones",
  }),
});

const enrichments: Enrichment[] = await response.json();

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2025-01-13T10:30:00.000Z",
    "updatedAt": "2025-01-13T10:30:00.000Z",
    "entityId": "550e8400-e29b-41d4-a716-446655440001",
    "entityType": "person",
    "field": "emails",
    "status": "pending",
    "error": null,
    "createdBy": "user_2abc123",
    "orgId": "org_xyz789",
    "globalEnrichmentId": null,
    "creditTransactionId": "txn_456def",
    "dataFound": null
  },
  {
    "id": "123e4567-e89b-12d3-a456-426614174001",
    "createdAt": "2025-01-13T10:30:00.000Z",
    "updatedAt": "2025-01-13T10:30:00.000Z",
    "entityId": "550e8400-e29b-41d4-a716-446655440002",
    "entityType": "person",
    "field": "emails",
    "status": "finished",
    "error": null,
    "createdBy": "user_2abc123",
    "orgId": "org_xyz789",
    "globalEnrichmentId": "global_789",
    "creditTransactionId": null,
    "dataFound": true
  }
]

[]

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "User ID is missing"
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Organization ID is missing"
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid enum value. Expected 'phones' | 'emails', received 'invalid'"
  }
}

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits for 50 enrichments. Required: 100 credits.",
    "details": {
      "operationType": "enrichment_email",
      "count": 50,
      "required": 100
    }
  }
}