Claims API

Claims API

The Claims API allows you to manage identity claims. Claims are typically created through the LMIF dashboard by creators, but platforms can query claim information.

Note

Most platforms only need the Identity Check API. The Claims API is primarily for creator-facing applications.

List Claims

List claims associated with your account.

Endpoint

GET /v1/lmif/claims

Request

SDK

const claims = await lmif.claims.list({
  limit: 20,
  status: 'verified'
});

cURL

curl https://api.lookmaimfamous.com/v1/lmif/claims?limit=20&status=verified \
  -H "Authorization: Bearer lmif_live_xxx"

Query Parameters

Parameter	Type	Description
limit	integer	Max items (default: 20, max: 100)
offset	integer	Items to skip
status	string	Filter by status: pending, verified, rejected
entityType	string	Filter by entity type

Response

{
  "data": [
    {
      "id": "claim_xyz789",
      "name": "Taylor Swift",
      "variations": ["T. Swift", "Taylor Alison Swift"],
      "entityType": "INDIVIDUAL",
      "status": "verified",
      "verificationTier": "GOLD",
      "createdAt": "2024-01-01T00:00:00Z",
      "verifiedAt": "2024-01-02T00:00:00Z",
      "hasBox": true,
      "boxId": "box_abc123"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 20,
    "offset": 0
  }
}

Get Claim

Get details of a specific claim.

Endpoint

GET /v1/lmif/claims/{id}

Request

SDK

const claim = await lmif.claims.get('claim_xyz789');

cURL

curl https://api.lookmaimfamous.com/v1/lmif/claims/claim_xyz789 \
  -H "Authorization: Bearer lmif_live_xxx"

Response

{
  "data": {
    "id": "claim_xyz789",
    "name": "Taylor Swift",
    "variations": ["T. Swift", "Taylor Alison Swift"],
    "entityType": "INDIVIDUAL",
    "status": "verified",
    "verificationTier": "GOLD",
    "verification": {
      "method": "stripe_identity",
      "completedAt": "2024-01-02T00:00:00Z",
      "documents": ["government_id"]
    },
    "proofs": [
      {
        "type": "social_verification",
        "platform": "twitter",
        "handle": "@taylorswift13",
        "verifiedAt": "2024-01-02T00:00:00Z"
      }
    ],
    "referenceImages": [
      {
        "id": "img_001",
        "url": "https://...",
        "isPrimary": true
      }
    ],
    "createdAt": "2024-01-01T00:00:00Z",
    "verifiedAt": "2024-01-02T00:00:00Z",
    "hasBox": true,
    "boxId": "box_abc123"
  }
}

Create Claim

Create a new identity claim.

Endpoint

POST /v1/lmif/claims

Request

SDK

const claim = await lmif.claims.create({
  name: "John Smith",
  variations: ["J. Smith", "Johnny Smith"],
  entityType: "INDIVIDUAL",
  referenceImages: [
    { url: "https://example.com/photo1.jpg", isPrimary: true },
    { url: "https://example.com/photo2.jpg" }
  ]
});

cURL

curl -X POST https://api.lookmaimfamous.com/v1/lmif/claims \
  -H "Authorization: Bearer lmif_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Smith",
    "variations": ["J. Smith", "Johnny Smith"],
    "entityType": "INDIVIDUAL",
    "referenceImages": [
      { "url": "https://example.com/photo1.jpg", "isPrimary": true }
    ]
  }'

Request Body

Field	Type	Required	Description
name	string	Yes	Primary name
variations	string[]	No	Alternate names/spellings
entityType	string	Yes	INDIVIDUAL, ESTATE, CORPORATION, AGENCY
referenceImages	array	Yes	Reference images for detection
referenceImages[].url	string	Yes	Image URL
referenceImages[].isPrimary	boolean	No	Primary reference image

Response

{
  "data": {
    "id": "claim_new123",
    "name": "John Smith",
    "variations": ["J. Smith", "Johnny Smith"],
    "entityType": "INDIVIDUAL",
    "status": "pending",
    "verificationTier": "BRONZE",
    "createdAt": "2024-01-15T10:00:00Z",
    "nextStep": {
      "action": "verify_identity",
      "url": "https://lookmaimfamous.com/verify/claim_new123"
    }
  }
}

Update Claim

Update an existing claim.

Endpoint

PATCH /v1/lmif/claims/{id}

Request

SDK

const updated = await lmif.claims.update('claim_xyz789', {
  variations: ["T. Swift", "Taylor Alison Swift", "Tay Tay"]
});

cURL

curl -X PATCH https://api.lookmaimfamous.com/v1/lmif/claims/claim_xyz789 \
  -H "Authorization: Bearer lmif_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "variations": ["T. Swift", "Taylor Alison Swift", "Tay Tay"]
  }'

Updateable Fields

Field	Description
variations	Alternate names
referenceImages	Reference images

Caution

The primary name cannot be changed after verification. Contact support if you need to change it.

Delete Claim

Delete a claim. This also removes any associated box.

Endpoint

DELETE /v1/lmif/claims/{id}

Request

SDK

await lmif.claims.delete('claim_xyz789');

cURL

curl -X DELETE https://api.lookmaimfamous.com/v1/lmif/claims/claim_xyz789 \
  -H "Authorization: Bearer lmif_live_xxx"

Response

{
  "data": {
    "id": "claim_xyz789",
    "deleted": true,
    "deletedAt": "2024-01-15T12:00:00Z"
  }
}

Add Variation

Add a name variation to a claim.

Endpoint

POST /v1/lmif/claims/{id}/variations

Request

await lmif.claims.addVariation('claim_xyz789', {
  variation: "Tay Tay"
});

Add Reference Image

Add a reference image to a claim.

Endpoint

POST /v1/lmif/claims/{id}/images

Request

await lmif.claims.addImage('claim_xyz789', {
  url: "https://example.com/new-photo.jpg",
  isPrimary: false
});

Claim Statuses

Status	Description
pending	Awaiting verification
verified	Identity verified
rejected	Verification failed
suspended	Temporarily suspended

Verification Tiers

Tier	Requirements	Benefits
GOLD	Stripe Identity + additional proof	Highest trust, fastest enforcement
SILVER	Stripe Identity	Full enforcement
BRONZE	Email only	Basic claim, limited enforcement