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>"
    }
  ],
  "submissionId": "<string>"
}
'

{
  "id": "<string>"
}

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>"
    }
  ],
  "submissionId": "<string>"
}
'

{
  "id": "<string>"
}

Path Parameters

formSiteId

string

required

Body

application/json

values

object[]

required

Show child attributes

values.elementId

string

required

values.periodUnit

number

required

values.sequence

number

required

values.value

any

submissionId

string

Response

Successful response

string

required

Get public form Get form

⌘I

Activity

ActivityDefinition

ApiKey

Dashboard

Widget

DatasetItem

Dataset

File

Form

FormElement

FormElementSubmission

FormSubmission

FormSite

Indicator

Organization

Site

Target

Benchmark

Unit

User

Submit public form

Path Parameters

Body

Response