pub.chive.claiming.getClaim

chive.pub

Documentation

Get a claim request by ID. Users can only view their own claims unless they are admins.

main query

Get a claim request by ID. Users can only view their own claims unless they are admins.

Parameters

claimId integer Required

ID of the claim request

Output

Encodingapplication/json
claim ref#claimRequest Optional

The claim request, or null if not found or not authorized

Errors

AuthenticationRequired Authentication is required to get claims
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
ID of the claim request
View raw schema 
{
  "type": "query",
  "errors": [
    {
      "name": "AuthenticationRequired",
      "description": "Authentication is required to get claims"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "properties": {
        "claim": {
          "ref": "#claimRequest",
          "type": "ref",
          "description": "The claim request, or null if not found or not authorized"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "claimId"
    ],
    "properties": {
      "claimId": {
        "type": "integer",
        "minimum": 1,
        "description": "ID of the claim request"
      }
    }
  },
  "description": "Get a claim request by ID. Users can only view their own claims unless they are admins."
}
claimRequest object

A claim request for an imported eprint

Properties

canonicalUri string at-uri Optional

AT-URI of the canonical record once created

claimantDid string did Required

DID of the user making the claim

createdAt string datetime Required

When the claim was created

expiresAt string datetime Optional

When the claim expires if not completed

id integer Required

Unique claim request ID

importId integer Required

ID of the imported eprint being claimed

rejectionReason string Optional

Reason for rejection if rejected

reviewedAt string datetime Optional

When the claim was reviewed

reviewedBy string did Optional

DID of the admin who reviewed the claim

status string Required

Current status of the claim

Known values: pending, approved, rejected, expired
View raw schema 
{
  "type": "object",
  "required": [
    "id",
    "importId",
    "claimantDid",
    "status",
    "createdAt"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Unique claim request ID"
    },
    "status": {
      "type": "string",
      "description": "Current status of the claim",
      "knownValues": [
        "pending",
        "approved",
        "rejected",
        "expired"
      ]
    },
    "importId": {
      "type": "integer",
      "description": "ID of the imported eprint being claimed"
    },
    "createdAt": {
      "type": "string",
      "format": "datetime",
      "description": "When the claim was created"
    },
    "expiresAt": {
      "type": "string",
      "format": "datetime",
      "description": "When the claim expires if not completed"
    },
    "reviewedAt": {
      "type": "string",
      "format": "datetime",
      "description": "When the claim was reviewed"
    },
    "reviewedBy": {
      "type": "string",
      "format": "did",
      "description": "DID of the admin who reviewed the claim"
    },
    "claimantDid": {
      "type": "string",
      "format": "did",
      "description": "DID of the user making the claim"
    },
    "canonicalUri": {
      "type": "string",
      "format": "at-uri",
      "description": "AT-URI of the canonical record once created"
    },
    "rejectionReason": {
      "type": "string",
      "description": "Reason for rejection if rejected"
    }
  },
  "description": "A claim request for an imported eprint"
}

Lexicon Garden

@