List a project's forms

GET

/api/v1/projects/{id}/forms

curl --request GET \
  --url https://api.deploybase.eu/api/v1/api/v1/projects/example/forms \
  --header 'Authorization: <Authorization>'

Returns a paginated list of forms with their submission counts.

Authorizations

• BearerAuth

Parameters

Path Parameters

id

required

string

Project ID

Query Parameters

page

integer

Page number (default: 1)

page_size

integer

Items per page (default: 20, max: 100)

Responses

200

OK

Media type application/json

object

data

meta

object

request_id

string

timestamp

string

trace_id

string

data

object

forms

Array<object>

object

allowed_origins

Array<string>

created_at

string

deleted_at

string

enabled

boolean

endpoint_url

string

honeypot_field

string

id

string

name

Name is the dashboard identity, unique per project among live rows only — a soft-deleted form releases its name (uq_forms_project_name_active).

string

notify_emails

Array<string>

notify_team

NotifyTeam says whether the team gets this form’s submission emails at all (members from NotifyEmails, else the team notification address). false sends them nothing, so a form can go to its external recipients alone; NotifyEmails is kept, not cleared, so switching back on restores the pick. External recipients are not governed by it.

No default:true in the GORM tag, deliberately, though the COLUMN defaults to true (see TeamIDPConnection.JitEnabled): GORM substitutes the tag default for a zero value on INSERT, so a form created with notify_team=false would be written true. Every writer states the value; CreateFormInput.NotifyTeam is a *bool resolved to true when omitted.

boolean

project_id

ProjectID is immutable after creation. This is enforced structurally rather than by a check: UpdateFormInput has no project_id field, so no code path can reassign it.

string

public_id

PublicID is immutable after creation: it is baked into the customer’s deployed HTML, so regenerating it would silently break every live form pointing at it.

string

redirect_url

string

retention_days

integer

source

string

Allowed values: manual build_detected

store_ip

string

Allowed values: none truncated

submission_count

integer

team_id

string

updated_at

string

page

integer

page_size

integer

total

integer

total_pages

integer

Example

{
  "data": {
    "forms": [
      {
        "source": "manual",
        "store_ip": "none"
      }
    ]
  }
}

400

Bad Request

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

401

Unauthorized

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

403

Forbidden

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}