Retrieve a form theme

GET

https://www.rapidoform.com/be/api/theme/survey/:surveyId

All requests require X-EMAIL and X-API-KEY. See authentication and errors. JSON request bodies also require Content-Type: application/json. All IDs in examples are synthetic; replace them with your own values.

Parameters

NameType / locationDescription
surveyIdpath numberRequired form ID.

Returns the assigned theme, with a default-theme fallback.

Example request

curl --request GET 'https://www.rapidoform.com/be/api/theme/survey/12345' \
  --header "X-EMAIL: $RAPIDOFORM_EMAIL" \
  --header "X-API-KEY: $RAPIDOFORM_API_KEY"

Response

Examples show selected fields, not every stored property. Empty arrays are valid for list/report endpoints.

{
  "Errors": [],
  "Info": [],
  "Data": [
    {
      "surveyTheme": {
        "_id": "000000000000000000000002",
        "themeName": "Brand theme",
        "backgroundColor": "#ffffff"
      }
    }
  ],
  "ErrorCode": "SUCCESS",
  "fieldErrors": {
    "List": []
  }
}

HTTP 200 alone does not indicate success. Check ErrorCode and Errors; see troubleshooting.