REST API Reference

Build decentralized identity solutions with our RESTful API endpoints for identity verification, credential management, and policy enforcement.

https://api.palap.org/v2/identity

API Endpoints

POST /identity Create a new decentralized identity

Request Body

{
  "did": "did:example:randomstring",
  "type": "VerifiableCredential",
  "publicKey": "base64EncodedKey"
}
                    

Response
{
  "id": "unique-identity-id",
  "created_at": "2025-08-26T12:34:56Z",
  "status": "active"
}
                    

GET /identity/verify Verify an identity

Query Parameters

?did=did:example:12345
                    

Response

{
  "valid": true,
  "timestamp": "2025-08-26T12:34:56Z",
  "issuer": "palap.org"
}
                    

Error Responses

401 Unauthorized
Missing or invalid API key
{"error": "unauthorized", "message": "Missing authentication header"}
                    
404 Not Found
Invalid identity ID
{"error": "not_found", "message": "Resource not available"}
                    

Authentication

Use API key authentication. Add an Authorization header with Bearer token:

Authorization: Bearer <your_api_key_here>

Learn more about authentication

Ready to Build?

Get started with our REST API for secure identity management across blockchain and decentralized systems.