Submit public form

curl --request POST \
  --url https://app.azalt.co/api/v1/forms/public/{formSiteId}/submit \
  --header 'Content-Type: application/json' \
  --data '
{
  "values": [
    {
      "elementId": "<string>",
      "periodUnit": 123,
      "sequence": 123,
      "value": "<unknown>",
      "selectedUnitId": "<string>"
    }
  ],
  "submissionId": "<string>"
}
'

{
  "id": "<string>",
  "score": {
    "totalScore": 123,
    "maxPossibleScore": 123,
    "tierAchieved": {
      "id": "<string>",
      "name": "<string>",
      "minScore": 123,
      "maxScore": 123,
      "color": "<string>",
      "description": "<string>"
    },
    "sectionScores": [
      {
        "sectionId": "<string>",
        "sectionName": "<string>",
        "points": 123,
        "maxPoints": 123
      }
    ]
  }
}

Form

Submit public form

Submit data to a public form without authentication, enabling external data collection.

Parameters:

formSiteId: Unique identifier for the form-site combination
password: Required if the form is password-protected
values: Array of form element values with their corresponding data
submitterInfo: Optional contact information for the submitter

Value Structure per Element:

elementId: Form element identifier
value: The actual data value (varies by element type)
periodUnit: For time-series data, specifies the period (e.g., monthly, quarterly)
docs: Optional file attachments supporting the data

Validation:

All required fields must be provided
Data types must match element configurations
Numeric values validated against min/max constraints
File uploads checked against allowed types and sizes

Common Use Cases:

Supplier environmental data collection
Third-party compliance reporting
Stakeholder sustainability surveys
External facility data submissions

POST

forms

public

{formSiteId}

submit

Submit public form

curl --request POST \
  --url https://app.azalt.co/api/v1/forms/public/{formSiteId}/submit \
  --header 'Content-Type: application/json' \
  --data '
{
  "values": [
    {
      "elementId": "<string>",
      "periodUnit": 123,
      "sequence": 123,
      "value": "<unknown>",
      "selectedUnitId": "<string>"
    }
  ],
  "submissionId": "<string>"
}
'

{
  "id": "<string>",
  "score": {
    "totalScore": 123,
    "maxPossibleScore": 123,
    "tierAchieved": {
      "id": "<string>",
      "name": "<string>",
      "minScore": 123,
      "maxScore": 123,
      "color": "<string>",
      "description": "<string>"
    },
    "sectionScores": [
      {
        "sectionId": "<string>",
        "sectionName": "<string>",
        "points": 123,
        "maxPoints": 123
      }
    ]
  }
}

Path Parameters

formSiteId

string

required

Body

application/json

values

object[]

required

Show child attributes

submissionId

string

Response

Successful response

string

required

score

object

Show child attributes

Get public form Get form