# credentials_orgs_users_assertions_retrieve_2

Endpoint to retrieve and update a specific credential assertion.

This endpoint allows retrieving details of a specific credential assertion
and updating its status (e.g., revoking it).

Path Parameters:
    org (str): The organization/tenant identifier
    user_id (str): The user ID making the request
    entity_id (str): The assertion entity ID

Methods:
    GET: Retrieve assertion details
    PUT: Update assertion status (e.g., revoke)

PUT Request Body:
    A JSON object containing:
    - revoked (bool): Set to true to revoke the assertion
    - revocationReason (str): Reason for revocation (required when revoking)

Returns:
    GET: A JSON response containing the assertion details using the AssertionSerializer format
    PUT: A JSON response containing the updated assertion using the AssertionSerializer format

Error Responses:
    400 Bad Request: If the request data is invalid
    401 Unauthorized: If the user is not authenticated
    403 Forbidden: If the user does not have permission to access this resource
    404 Not Found: If the assertion doesn't exist
    500 Internal Server Error: If an unexpected error occurs

Endpoint: GET /api/credentials/orgs/{org}/users/{user_id}/assertions/{entity_id}
Version: 3.59.0-ai-plus
Security: PlatformApiKeyAuthentication

## Path parameters:

  - `entity_id` (string, required)

  - `org` (string, required)

  - `user_id` (string, required)

## Response 200 fields (application/json):

  - `entityId` (string, required)

  - `issuedOn` (string, required)

  - `credentialDetails` (object, required)

  - `recipient` (object, required)

  - `metadata` (any,null)

  - `course` (object, required)

  - `program` (object, required)

  - `narrative` (string,null)

  - `revoked` (boolean)

  - `revocationReason` (string, required)

  - `acceptance` (string)
    *  - Unaccepted
*  - Accepted
*  - Rejected
    Enum: "Unaccepted", "Accepted", "Rejected"

  - `expires` (string, required)