GET
/
auth
/
:jwk_id
curl https://production.methodfi.com/auth/mthd_jwk_12
{
  "success": true,
  "data": {
    "id": "mthd_jwk_12",
    "kid": "mthd_jwk_12",
    "kty": "RSA",
    "alg": "RSA-OAEP-256",
    "use": "enc",
    "n": "s3C9N7Vz...J7c",
    "e": "AQAB",
    "status": "active",
    "created_at": "2024-01-15T10:30:00Z", 
    "updated_at": "2024-01-15T10:30:00Z"
  },
  "message": null
}
Retrieves a specific Method public key by its ID. This endpoint is particularly useful when subscribing to webhook notifications for Method JWK events (method_jwk.create and method_jwk.update), as the webhook payload includes a path field pointing to this endpoint.
This endpoint retrieves Method’s public keys (used for encrypting your requests), not your own registered keys. To manage your own keys, use the TEAM JWKS API.

Path Parameters

jwk_id
string
required
The unique identifier of the Method public key (e.g., 'mthd_jwk_12').

Webhook Integration

When you subscribe to method_jwk.create or method_jwk.update webhook events, the webhook payload will include a path field like /auth/mthd_jwk_12. You can make a GET request to this path to retrieve the updated key information. Example webhook event object:
{
  "id": "mthd_jwk_12",
  "type": "method_jwk.update",
  "path": "/auth/mthd_jwk_12",
  "event": "evt_knqJgxKUnqDVJ"
}

Returns

Returns the specified Method public key object with its current status and metadata.
curl https://production.methodfi.com/auth/mthd_jwk_12
{
  "success": true,
  "data": {
    "id": "mthd_jwk_12",
    "kid": "mthd_jwk_12",
    "kty": "RSA",
    "alg": "RSA-OAEP-256",
    "use": "enc",
    "n": "s3C9N7Vz...J7c",
    "e": "AQAB",
    "status": "active",
    "created_at": "2024-01-15T10:30:00Z", 
    "updated_at": "2024-01-15T10:30:00Z"
  },
  "message": null
}

Use Cases

This endpoint is commonly used for:
  • Webhook Processing: Automatically fetch updated key information when receiving method_jwk.create or method_jwk.update webhooks
  • Key Validation: Verify the current status and details of a specific Method public key
  • Cache Updates: Refresh your cached Method public keys when notified of changes
  • Key Rotation Handling: Retrieve new active keys or check the status of deprecated keys