Validate Certificate

curl --request POST \
  --url http://localhost:8000/issuers/certificates/validate \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=<string>' \
  --form 'password=<string>' \
  --form 'ruc=<string>'

{
  "valid": true,
  "subject_cn": "<string>",
  "serial_number": "<string>",
  "valid_from": "2023-11-07T05:31:56Z",
  "valid_until": "2023-11-07T05:31:56Z",
  "status": "<string>",
  "error_detail": "<string>"
}

certificates

Validate Certificate

Validate a .p12 certificate without persisting it.

Validates the certificate structure, extracts metadata, determines status, and optionally cross-validates the certificate CN against the SRI legal name for the given RUC.

This endpoint is designed for wizard flows where validation is needed before final submission.

Args: file: .p12 certificate file password: Certificate password ruc: Optional RUC to cross-validate against certificate CN db: Async database session for SRI cache lookups

Returns: ValidateCertificateResponse: Validation result with metadata or error

Raises: HTTPException 422: If file cannot be read

POST

issuers

certificates

validate

Validate Certificate

curl --request POST \
  --url http://localhost:8000/issuers/certificates/validate \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=<string>' \
  --form 'password=<string>' \
  --form 'ruc=<string>'

{
  "valid": true,
  "subject_cn": "<string>",
  "serial_number": "<string>",
  "valid_from": "2023-11-07T05:31:56Z",
  "valid_until": "2023-11-07T05:31:56Z",
  "status": "<string>",
  "error_detail": "<string>"
}

Headers

authorization

string | null

x-api-key

string | null

x-tenant-id

string | null

Cookies

factio_access_token

string | null

Body

multipart/form-data

file

string

required

.p12 certificate file

password

string

required

Certificate password

ruc

string | null

RUC to cross-validate against certificate CN

Response

Successful Response

Response for certificate validation without persistence.

valid

boolean

required

Whether the certificate is valid

subject_cn

string | null

Certificate subject common name

serial_number

string | null

Certificate serial number

valid_from

string<date-time> | null

Certificate validity start date

valid_until

string<date-time> | null

Certificate validity end date

status

string | null

Certificate status: active, expiring, expired

error_detail

string | null

Error message if validation failed

Restore Establishment List Certificates