@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api spec
@base https://api.ote-godaddy.com
@endpoints 28
@hint download_for_search
@toc certificates(23), customers(5)

@group certificates
@endpoint POST /v1/certificates
@required {certificateCreate: any}
@optional {X-Market-Id: any}
@returns(202)
@errors {400, 401, 403, 409, 422, 500}

@endpoint POST /v1/certificates/validate
@required {certificateCreate: any}
@optional {X-Market-Id: any}
@returns(204)
@errors {400, 401, 403, 409, 422, 500}

@endpoint GET /v1/certificates/{certificateId}
@required {certificateId: any}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v1/certificates/{certificateId}/actions
@required {certificateId: any}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint POST /v1/certificates/{certificateId}/email/{emailId}/resend
@required {certificateId: any, emailId: any}
@returns(204)
@errors {404, 409, 500}

@endpoint POST /v1/certificates/{certificateId}/email/resend/{emailAddress}
@required {certificateId: any, emailAddress: any}
@returns(200)
@errors {404, 409, 500}

@endpoint POST /v1/certificates/{certificateId}/email/{emailId}/resend/{emailAddress}
@required {certificateId: any, emailId: any, emailAddress: any}
@returns(204)
@errors {404, 409, 500}

@endpoint GET /v1/certificates/{certificateId}/email/history
@required {certificateId: any}
@returns(200)
@errors {409, 500}

@endpoint DELETE /v1/certificates/{certificateId}/callback
@required {certificateId: any}
@returns(204)
@errors {400, 401, 403, 404, 500}

@endpoint GET /v1/certificates/{certificateId}/callback
@required {certificateId: any}
@returns(200)
@errors {400, 401, 403, 404, 500}

@endpoint PUT /v1/certificates/{certificateId}/callback
@required {certificateId: any, callbackUrl: any}
@returns(204)
@errors {400, 401, 403, 404, 422, 500}

@endpoint POST /v1/certificates/{certificateId}/cancel
@required {certificateId: any}
@returns(204)
@errors {401, 403, 404, 409, 500}

@endpoint GET /v1/certificates/{certificateId}/download
@required {certificateId: any}
@returns(200)
@errors {400, 401, 403, 404, 409, 500}

@endpoint POST /v1/certificates/{certificateId}/reissue
@required {certificateId: any, reissueCreate: any}
@returns(202)
@errors {400, 401, 403, 404, 409, 422, 500}

@endpoint POST /v1/certificates/{certificateId}/renew
@required {certificateId: any, renewCreate: any}
@returns(202)
@errors {400, 401, 403, 404, 409, 422, 500}

@endpoint POST /v1/certificates/{certificateId}/revoke
@required {certificateId: any, certificateRevoke: any}
@returns(204)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v1/certificates/{certificateId}/siteSeal
@required {certificateId: any}
@optional {theme: any, locale: any}
@returns(200)
@errors {400, 401, 403, 404, 409, 422, 500}

@endpoint POST /v1/certificates/{certificateId}/verifyDomainControl
@required {certificateId: any}
@returns(204)
@errors {400, 401, 403, 404, 409, 500}

@endpoint GET /v2/certificates
@required {entitlementId: any}
@optional {latest: any}
@returns(200)
@errors {400, 401, 403, 422, 500}

@endpoint POST /v2/certificates
@required {subscriptionCertificateCreate: any}
@optional {X-Market-Id: any}
@returns(202)
@errors {400, 401, 403, 409, 422, 500}

@endpoint GET /v2/certificates/download
@required {entitlementId: any}
@returns(200)
@errors {400, 401, 403, 404, 409, 422, 500}

@endgroup

@group customers
@endpoint GET /v2/customers/{customerId}/certificates
@required {customerId: any}
@optional {offset: any, limit: any}
@returns(200)
@errors {401, 403, 422, 429, 500}

@endpoint GET /v2/customers/{customerId}/certificates/{certificateId}
@required {customerId: any, certificateId: any}
@returns(200)
@errors {401, 403, 404, 422, 429, 500}

@endpoint GET /v2/customers/{customerId}/certificates/{certificateId}/domainVerifications
@required {customerId: any, certificateId: any}
@returns(200)
@errors {401, 403, 404, 422, 429, 500}

@endpoint GET /v2/customers/{customerId}/certificates/{certificateId}/domainVerifications/{domain}
@required {customerId: any, certificateId: any, domain: any}
@returns(200)
@errors {401, 403, 404, 422, 429, 500}

@endpoint GET /v2/customers/{customerId}/certificates/acme/externalAccountBinding
@required {customerId: any}
@returns(200)
@errors {401, 403, 404, 422, 429, 500}

@endgroup

@group certificates
@endpoint GET /v2/certificates/subscriptions/search
@optional {pageSize: any, page: any, domain: any, status: any, type: any, validation: any}
@returns(200)

@endpoint GET /v2/certificates/subscription/{guid}
@required {guid: any}
@optional {pageSize: any, page: any, domain: any, status: any, type: any, validation: any}
@returns(200)

@endgroup

@end