Certificates

GET /certificates/{environment}

Returns a list of the user's certificates for a given environment.

Path Parameters

Parameter	Type	Required	Description
environment	string	✅	test, demo, or prod

Response 200

{
  "certificates": [
    {
      "id": "uuid",
      "nip": "9570429696",
      "subjectName": "C=PL, O=Firma XYZ",
      "shortName": "Test cert",
      "environment": "test",
      "certificateType": "auth",
      "status": "active",
      "certExpiry": "2027-01-01 00:00:00",
      "createdAt": "2026-01-01 12:00:00"
    }
  ]
}

Field	Type	Description
id	string (uuid)	Certificate ID
nip	string	Company NIP number
subjectName	string	Full subject name
shortName	string	Short/display name
environment	string	KSeF environment (test, demo, prod)
certificateType	string	Certificate type: auth (authentication) or offline (offline signing)
status	string	Certificate status: active, revoked, or expired
certExpiry	string	Certificate expiry date
createdAt	string	Creation date

Error Codes

Code	Description
401	Unauthorized