Skip to content

Area: Developers

POST

Get remaining trial days

Path
/partners/domains/trialDays
Auth
Partner token · partner server only
POST
/partners/domains/trialDays
Code sample: cURL
# $SIGNED_PAYLOAD: the request claims as a JWT signed with your private key, see https://releva.ai/documentation/reference/partners/overview/#authentication
curl --request POST \
--url 'https://releva.ai/api/v0/partners/domains/trialDays' \
--header 'content-type: application/json' \
--header "x-rlv-partner-token: $RELEVA_PARTNER_TOKEN" \
--data "{\"payload\": \"$SIGNED_PAYLOAD\"}"

Returns the trial days left in the shop’s current billing period, or 30 when the shop has no billing period yet. Only for partners that bill their merchants themselves (external billing).

Media typeapplication/json
object
payload
required

The request fields as JWT claims, signed with your RSA private key (RS512 recommended; RS256/384 and PS256/384/512 are also accepted) with a short expiry (expiresIn: '1h'). The operation’s x-signed-claims schema lists the claims.

string

Example generated

{
"payload": "example"
}

Remaining trial days.

Media typeapplication/json
object
trialDays
required
integer

Example

{
"trialDays": 30
}

Partner token, shop lookup or billing mode error.

Media typeapplication/json
object
message
required

Human-readable error. Several validation errors are joined with a space.

string

Examples

{
"message": "Partner identification is missing!"
}

The payload could not be verified (missing, not a JWT, signed with another key, or expired), or another unexpected error.

Media typeapplication/json
object
message
required

Human-readable error. Several validation errors are joined with a space.

string

Example

{
"message": "An internal error occurred."
}