---
updatedAt: 2026-09-15T13:43:53.000Z
agentTools:
projectIndex: https://dev.helloasso.com/llms.txt
---
# Obtenir les formulaires d'une organisation
Liste tous les formulaires correspondant aux états et types. Si aucun filtre n'est spécifié, aucun filtre n'est appliqué. Les résultats sont classés par date de création en ordre décroissant.
Votre clientId doit être autorisé à tous ces privilèges :
AccessPublicData
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "HelloAsso API",
"description": "HelloAsso auto-generated SDK",
"version": "public"
},
"servers": [
{
"url": "https://api.helloasso.com/v5"
}
],
"paths": {
"/organizations/{organizationSlug}/forms": {
"get": {
"tags": [
"Formulaires"
],
"summary": "Obtenir les formulaires d'une organisation",
"description": "Liste tous les formulaires correspondant aux états et types. Si aucun filtre n'est spécifié, aucun filtre n'est appliqué. Les résultats sont classés par date de création en ordre décroissant.
Votre clientId doit être autorisé à tous ces privilèges :
AccessPublicData
",
"parameters": [
{
"name": "organizationSlug",
"in": "path",
"description": "The organization Slug",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "states",
"in": "query",
"description": "States to filter\n\nAvailable values:\n* `Public` - The form is publicly visible and findable on search engines\n* `Private` - The form is visible only with the URL, you cannot find it on search engines\n* `Draft` - The form is not yet published but visible if you have admin rights\n* `Disabled` - The form is disabled and can be reenabled by changing state to public or private",
"schema": {
"title": "List",
"type": "array",
"items": {
"$ref": "#/components/schemas/HelloAsso.Api.V5.Common.Models.Enums.FormState"
}
}
},
{
"name": "formTypes",
"in": "query",
"description": "Types to filter",
"schema": {
"title": "List",
"type": "array",
"items": {
"$ref": "#/components/schemas/HelloAsso.Api.V5.Common.Models.Enums.FormType"
}
}
},
{
"name": "pageIndex",
"in": "query",
"description": "The page of results to retrieve",
"schema": {
"type": "integer",
"format": "int32",
"default": 1
}
},
{
"name": "pageSize",
"in": "query",
"description": "The number of items per page",
"schema": {
"type": "integer",
"format": "int32",
"default": 20
}
},
{
"name": "continuationToken",
"in": "query",
"description": "Continuation Token from which we wish to retrieve results",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/HelloAsso.Api.V5.Common.Models.Common.ResultsWithPaginationModel_FormLightModel"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/HelloAsso.Api.V5.Common.Models.Common.ResultsWithPaginationModel_FormLightModel"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/HelloAsso.Api.V5.Common.Models.Common.ResultsWithPaginationModel_FormLightModel"
}
}
}
},
"401": {
"description": "Unauthorized, you must add a valid JWT into Authorization Header with the format : `Bearer TOKEN`"
},
"403": {
"description": "The JWT token hasn't the privileges or Roles for this action"
}
},
"security": [
{
"OAuth2": []
}
]
}
}
},
"components": {
"schemas": {
"HelloAsso.Api.V5.Common.Models.Common.DocumentModel": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int32",
"nullable": true
},
"fileName": {
"type": "string",
"description": "The file name of document",
"nullable": true
},
"publicUrl": {
"type": "string",
"description": "The public url of document",
"nullable": true
},
"state": {
"$ref": "#/components/schemas/HelloAsso.Api.V5.Common.Models.ComplianceV2.Documents.DocumentState"
}
},
"additionalProperties": false,
"description": "DocumentModel class"
},
"HelloAsso.Api.V5.Common.Models.Common.MetaModel": {
"type": "object",
"properties": {
"createdAt": {
"type": "string",
"format": "date-time"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"authorEmail": {
"type": "string",
"nullable": true
},
"expiresAt": {
"type": "string",
"format": "date-time",
"nullable": true
}
},
"additionalProperties": false
},
"HelloAsso.Api.V5.Common.Models.Common.PaginationModel": {
"type": "object",
"properties": {
"pageSize": {
"type": "integer",
"description": "Page size",
"format": "int32"
},
"totalCount": {
"type": "integer",
"description": "Total number of results available",
"format": "int32"
},
"pageIndex": {
"type": "integer",
"description": "Current page index",
"format": "int32"
},
"totalPages": {
"type": "integer",
"description": "Total number of pages of results with current page size",
"format": "int32"
},
"continuationToken": {
"type": "string",
"description": "Continuation Token to get next results",
"nullable": true
}
},
"additionalProperties": false,
"description": "Pagination model class"
},
"HelloAsso.Api.V5.Common.Models.Common.ResultsWithPaginationModel_FormLightModel": {
"title": "ResultsWithPaginationModel",
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/HelloAsso.Api.V5.Common.Models.Forms.FormLightModel"
},
"description": "Data property",
"nullable": true
},
"pagination": {
"$ref": "#/components/schemas/HelloAsso.Api.V5.Common.Models.Common.PaginationModel"
}
},
"additionalProperties": false,
"description": "ResultsWithPaginationModel class"
},
"HelloAsso.Api.V5.Common.Models.ComplianceV2.Documents.DocumentState": {
"enum": [
"Saved",
"Pending",
"Rejected",
"Accepted"
],
"type": "string"
},
"HelloAsso.Api.V5.Common.Models.Enums.FormState": {
"enum": [
"Public",
"Private",
"Draft",
"Deleted",
"Disabled"
],
"type": "string"
},
"HelloAsso.Api.V5.Common.Models.Enums.FormType": {
"enum": [
"CrowdFunding",
"Membership",
"Event",
"Donation",
"PaymentForm",
"Checkout",
"Shop"
],
"type": "string"
},
"HelloAsso.Api.V5.Common.Models.Forms.FormLightModel": {
"type": "object",
"properties": {
"banner": {
"$ref": "#/components/schemas/HelloAsso.Api.V5.Common.Models.Common.DocumentModel"
},
"currency": {
"type": "string",
"description": "Currency",
"nullable": true
},
"description": {
"type": "string",
"description": "Short description (one line)",
"nullable": true
},
"startDate": {
"type": "string",
"description": "The datetime of the activity start",
"format": "date-time",
"nullable": true
},
"endDate": {
"type": "string",
"description": "The datetime of the activity end",
"format": "date-time",
"nullable": true
},
"logo": {
"$ref": "#/components/schemas/HelloAsso.Api.V5.Common.Models.Common.DocumentModel"
},
"meta": {
"$ref": "#/components/schemas/HelloAsso.Api.V5.Common.Models.Common.MetaModel"
},
"state": {
"$ref": "#/components/schemas/HelloAsso.Api.V5.Common.Models.Enums.FormState"
},
"title": {
"type": "string",
"description": "Title",
"nullable": true
},
"privateTitle": {
"type": "string",
"description": "Private Title",
"nullable": true
},
"widgetButtonUrl": {
"type": "string",
"description": "Url of the widget button",
"nullable": true
},
"widgetFullUrl": {
"type": "string",
"description": "Url of the form widget",
"nullable": true
},
"widgetVignetteHorizontalUrl": {
"type": "string",
"description": "Url of the horizontal vignette widget",
"nullable": true
},
"widgetVignetteVerticalUrl": {
"type": "string",
"description": "Url of the vertical vignette widget",
"nullable": true
},
"widgetCounterUrl": {
"type": "string",
"description": "Url of the counter widget",
"nullable": true
},
"formSlug": {
"type": "string",
"description": "The form slug",
"nullable": true
},
"formType": {
"$ref": "#/components/schemas/HelloAsso.Api.V5.Common.Models.Enums.FormType"
},
"url": {
"type": "string",
"description": "The form url",
"nullable": true
},
"organizationSlug": {
"type": "string",
"description": "The organization slug",
"nullable": true
}
},
"additionalProperties": false,
"description": "FormLightModel class"
}
},
"securitySchemes": {
"OAuth2": {
"type": "oauth2",
"flows": {
"clientCredentials": {
"tokenUrl": "https://api.helloasso.com/oauth2/token",
"scopes": {}
}
}
}
}
},
"x-readme": {
"samples-languages": [
"shell",
"php",
"javascript",
"python",
"node"
]
}
}
```