---
updatedAt: 2026-04-21T09:29:18.000Z
agentTools:
  projectIndex: https://partner.getpliant.com/llms.txt
---

# Get Partner Signing Public Key (JWKS)

> 🔒 **Required scope:** `platform:read`
>
> The API credential calling this endpoint must be granted the `platform` category with `read` or `read & write` access.
> Scopes are assigned to the credential when it is created or edited in Pliant, not requested when obtaining the access token.
> A credential without this scope receives `403 Forbidden` with the error code `INSUFFICIENT_PERMISSION`.

Returns a JSON Web Key Set (JWKS) containing a single public Ed25519 key for the authenticated partner.

This public key is used to verify signatures in two scenarios:
- **Callback signing**: Verify [callback authenticity](/docs/callbacks)
- **Redirect signing**: Verify [redirect signatures](/docs/existing-pliant-customer-starts-integration)

**Important**: This key is per partner and is identified by the currently authenticated partner. The key is stable and there are currently no plans to rotate it. Consumers should cache this key and avoid fetching it frequently. Only fetch the key again if signature verification fails, as this may indicate a key rotation (though none is currently planned).


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "contact": {
      "name": "API Support",
      "email": "support@getpliant.com",
      "url": "https://www.getpliant.com"
    },
    "title": "Pliant Partner API",
    "description": "Pliant Partner API",
    "version": "2.1.0",
    "license": {
      "name": "MIT",
      "url": "https://opensource.org/license/MIT"
    }
  },
  "servers": [
    {
      "url": "https://partner-api.getpliant.com/api",
      "description": "Pliant Production Server"
    },
    {
      "url": "https://sandbox.partner-api.getpliant.com/api",
      "description": "Pliant Sandbox Server"
    },
    {
      "url": "https://pci-api.getpliant.com",
      "description": "PCI Vault Production Server"
    },
    {
      "url": "https://pci-sandbox.partner-api.getpliant.com",
      "description": "PCI Vault Sandbox Server"
    }
  ],
  "x-readme": {
    "explorer-enabled": false,
    "samples-languages": [
      "curl",
      "java",
      "kotlin"
    ],
    "headers": [
      {
        "key": "Pliant-API-Version",
        "value": "2.1.0"
      }
    ]
  },
  "tags": [
    {
      "name": "Misc",
      "description": "This tag is for miscellaneous operations"
    }
  ],
  "paths": {
    "/partner-management/signing/jwks.json": {
      "get": {
        "summary": "Get Partner Signing Public Key (JWKS)",
        "description": "> 🔒 **Required scope:** `platform:read`\n>\n> The API credential calling this endpoint must be granted the `platform` category with `read` or `read & write` access.\n> Scopes are assigned to the credential when it is created or edited in Pliant, not requested when obtaining the access token.\n> A credential without this scope receives `403 Forbidden` with the error code `INSUFFICIENT_PERMISSION`.\n\nReturns a JSON Web Key Set (JWKS) containing a single public Ed25519 key for the authenticated partner.\n\nThis public key is used to verify signatures in two scenarios:\n- **Callback signing**: Verify [callback authenticity](/docs/callbacks)\n- **Redirect signing**: Verify [redirect signatures](/docs/existing-pliant-customer-starts-integration)\n\n**Important**: This key is per partner and is identified by the currently authenticated partner. The key is stable and there are currently no plans to rotate it. Consumers should cache this key and avoid fetching it frequently. Only fetch the key again if signature verification fails, as this may indicate a key rotation (though none is currently planned).\n",
        "x-required-scopes": [
          "platform:read"
        ],
        "tags": [
          "Misc"
        ],
        "operationId": "get-partner-signing-jwks",
        "responses": {
          "200": {
            "description": "Ok",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerSigningJwks"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "500": {
            "$ref": "#/components/responses/500"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "This API uses oAuth2 with client credentials flow to [obtain the Bearer Token](/docs/authenticated-api-usage).",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "errorCode": {
            "type": "string",
            "description": "The error code"
          },
          "exceptionId": {
            "type": "string",
            "format": "uuid",
            "description": "The id of the exception that was thrown"
          },
          "message": {
            "type": "string",
            "description": "The cause of the error or further explanations on the error"
          }
        }
      },
      "PartnerSigningJwks": {
        "type": "object",
        "description": "JSON Web Key Set (JWKS) containing the partner's public Ed25519 signing key",
        "required": [
          "keys"
        ],
        "properties": {
          "keys": {
            "type": "array",
            "description": "Array of JSON Web Keys",
            "items": {
              "type": "object",
              "description": "JSON Web Key (JWK) for Ed25519 public key",
              "required": [
                "kty",
                "use",
                "crv",
                "kid",
                "key_ops",
                "x",
                "alg"
              ],
              "properties": {
                "kty": {
                  "type": "string",
                  "enum": [
                    "OKP"
                  ],
                  "description": "Key type - OKP (Octet Key Pair) for Ed25519",
                  "example": "OKP"
                },
                "use": {
                  "type": "string",
                  "enum": [
                    "sig"
                  ],
                  "description": "Key use - indicates the key is for signing",
                  "example": "sig"
                },
                "crv": {
                  "type": "string",
                  "enum": [
                    "Ed25519"
                  ],
                  "description": "Curve name for Ed25519",
                  "example": "Ed25519"
                },
                "kid": {
                  "type": "string",
                  "description": "Key ID - unique identifier for this key, derived from the key material",
                  "example": "x4_cic8wT7GiHGhLR7OA5VAC6U3Dn5MDWNTDlCk_Qe4"
                },
                "key_ops": {
                  "type": "array",
                  "description": "Key operations - indicates this key can be used for verification",
                  "items": {
                    "type": "string",
                    "enum": [
                      "verify"
                    ]
                  },
                  "example": [
                    "verify"
                  ]
                },
                "x": {
                  "type": "string",
                  "description": "The public key value, base64url-encoded",
                  "example": "ybZX6AKkLQ2fPIUb_RelEpB7gThMVtuPiDn5upltFxI"
                },
                "alg": {
                  "type": "string",
                  "enum": [
                    "EdDSA"
                  ],
                  "description": "Algorithm - EdDSA for Ed25519",
                  "example": "EdDSA"
                }
              }
            }
          }
        },
        "example": {
          "keys": [
            {
              "kty": "OKP",
              "use": "sig",
              "crv": "Ed25519",
              "kid": "x4_cic8wT7GiHGhLR7OA5VAC6U3Dn5MDWNTDlCk_Qe4",
              "key_ops": [
                "verify"
              ],
              "x": "ybZX6AKkLQ2fPIUb_RelEpB7gThMVtuPiDn5upltFxI",
              "alg": "EdDSA"
            }
          ]
        }
      }
    },
    "responses": {
      "401": {
        "description": "Unauthorized. The API consumer is not authorized to access the requested resource.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "429": {
        "description": "Too Many Requests. The API consumer has sent too many requests in a given amount of time. Please check our [API guidelines](/docs/pliant-api-guidelines#api-rate-limits).",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "error": {
                  "type": "string",
                  "description": "Detailed description of the error and breached rate limit."
                }
              }
            }
          }
        }
      },
      "500": {
        "description": "Internal Server Error. The request was not completed due to an internal error.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
```