REST API · Account and sign-up
Finish a sign-up with the emailed code
https://platform.casafari.com/v1/signups/{signup_id}/verifyNo key needed: this is how a person or an agent opens an account and gets its first API key. See platform API keys.
Over MCP: no tool does this.
Description
Returns the account and an API key, shown once.
Path parameters
signup_idstringrequiredRequest body
Content type application/json. Required. Type: object.
codestringrequiredExample request
Placeholders only: replace the token and the values with your own.
curl -X POST "https://platform.casafari.com/v1/signups/<signup_id>/verify" \
-H "Content-Type: application/json" \
-d '{
"code": "<code>"
}'Responses
201 Account opened.
Type: object.
Show the response shape (14 fields)
account_idstringrequireduser_idstringapi_keystringrequiredkey_idstringkey_hintstringscopesstring[]requiredplanobjectrequired3 properties
idstringtrial_unitsintegernullabletrial_ends_atstring (date-time)nullableapi_base_urlstring (uri)resourcesobjectconsole_urlstring (uri)docs_urlstring (uri)Errors
Every error is an application/problem+json body (RFC 9457) with type (a page that explains it), title, status, detail (what to do), instance, code and request_id (what to quote to support). A 402 carries an upgrade_url, a 429 a Retry-After header. The codes each status can carry:
- 400
invalid_request,email_not_allowed,terms_not_accepted,verification_code_invalid,verification_code_expired(https://platform.casafari.com/errors/invalid-request, https://platform.casafari.com/errors/email-not-allowed, https://platform.casafari.com/errors/terms-not-accepted, https://platform.casafari.com/errors/verification-code-invalid, https://platform.casafari.com/errors/verification-code-expired) - 404
not_found(https://platform.casafari.com/errors/not-found) - 405
method_not_allowed(https://platform.casafari.com/errors/method-not-allowed) - 429
signup_limited,rate_limited(https://platform.casafari.com/errors/signup-limited, https://platform.casafari.com/errors/rate-limited) - 500
internal_error(https://platform.casafari.com/errors/internal-error) - 503
unavailable(https://platform.casafari.com/errors/unavailable)