API Documentation

Register a new partner and receive an API key.

{
  "name": "My Marketplace",
  "slug": "my-marketplace"
}

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My Marketplace",
  "slug": "my-marketplace",
  "apiKey": "mir_abc123...",
  "message": "Save your API key - it cannot be retrieved later"
}

List all active partners (public information only).

{
  "partners": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "My Marketplace",
      "slug": "my-marketplace",
      "createdAt": "2025-01-15T10:30:00.000Z"
    }
  ]
}

Get a partner by their unique slug.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My Marketplace",
  "slug": "my-marketplace",
  "status": "ACTIVE",
  "createdAt": "2025-01-15T10:30:00.000Z"
}

Submit a reputation event for a user. If the user doesn't exist, they will be created automatically.

{
  "userExternalId": "user_12345",
  "eventType": "transaction.completed",
  "weight": 1.0,
  "occurredAt": "2025-01-15T14:30:00.000Z",
  "meta": {
    "amount": 149.99,
    "currency": "USD"
  }
}

{
  "id": "event_abc123",
  "userId": "550e8400-e29b-41d4-a716-446655440000",
  "eventType": "transaction.completed",
  "weight": 1.0,
  "occurredAt": "2025-01-15T14:30:00.000Z",
  "createdAt": "2025-01-15T14:30:05.000Z"
}

List events submitted by your partner account.

{
  "events": [
    {
      "id": "event_abc123",
      "eventType": "transaction.completed",
      "weight": 1.0,
      "occurredAt": "2025-01-15T14:30:00.000Z",
      "user": {
        "id": "550e8400-...",
        "displayName": null
      }
    }
  ]
}

Get user profile and linked accounts. For history signals, use /resolve instead.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "displayName": null,
  "status": "ACTIVE",
  "createdAt": "2025-01-10T08:00:00.000Z",
  "linkedAccounts": [
    {
      "id": "la_123",
      "provider": "my-marketplace",
      "providerUserId": "user_12345",
      "createdAt": "2025-01-10T08:00:00.000Z"
    }
  ]
}

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "displayName": null,
  "status": "ACTIVE",
  "createdAt": "2025-01-10T08:00:00.000Z",
  "linkedAccount": {
    "provider": "my-marketplace",
    "providerUserId": "user_12345",
    "createdAt": "2025-01-10T08:00:00.000Z"
  }
}

Resolve a partner-linked user to neutral history signals. Returns factual data about history depth—not scores, ratings, or judgments.

curl "https://myinternetreputation.org/resolve?userExternalId=user_12345" \
  -H "x-api-key: mir_your_api_key"

{
  "mirUserId": "550e8400-e29b-41d4-a716-446655440000",
  "partnerLinkedAt": "2025-01-10T08:00:00.000Z",
  "history": {
    "hasHistory": true,
    "tier": "established",
    "tierBasis": "eventCount",
    "evidenceConfidence": 0.65,
    "signals": {
      "eventCount": 23,
      "distinctPartners": 3,
      "accountAgeDays": 142,
      "firstEventDaysAgo": 138,
      "lastEventDaysAgo": 2
    },
    "noticeCode": "HISTORY_VOLUME_ONLY",
    "notice": "History tiers reflect volume of verified events only, not user quality."
  }
}

Step 1: Generate an invite link for your user. Send them to MIR to authenticate.

curl -X POST https://myinternetreputation.org/partners/link/invite \
  -H "Content-Type: application/json" \
  -H "x-api-key: mir_your_api_key" \
  -d '{
    "userExternalId": "your-user-456",
    "callbackUrl": "https://yoursite.com/mir-callback"
  }'

{
  "inviteUrl": "https://myinternetreputation.org/link?token=abc123...",
  "expiresAt": "2025-01-15T15:00:00.000Z"
}

Redirect your user to inviteUrl. They'll log into MIR (or create an account), then be redirected back to your callbackUrl with a success/failure status.

Alternative: Generate a short code for users to enter manually (useful for mobile apps or TVs).

curl -X POST https://myinternetreputation.org/partners/link/code \
  -H "Content-Type: application/json" \
  -H "x-api-key: mir_your_api_key" \
  -d '{
    "userExternalId": "your-user-456"
  }'

{
  "code": "ABCD-1234",
  "expiresAt": "2025-01-15T15:10:00.000Z",
  "instructions": "Visit myinternetreputation.org/link and enter this code"
}

Display the code to your user. They visit MIR, log in, and enter the code to link their account.