organizations

Organization related operations

List or search all organizations

get

Paramètres de requête

qstringOptionnel

The search query

sortstring · enumOptionnel

The field (and direction) on which sorting apply

Valeurs possibles:

pageintegerOptionnel

The page to display

page_sizeintegerOptionnel

The page size

badgestring · enumOptionnelValeurs possibles:

namestringOptionnel

business_number_idstringOptionnel

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

next_pagestringOptionnel

The next page URL if exists

pageinteger · min: 1Requis

The current page

page_sizeintegerRequis

The page size used for pagination

previous_pagestringOptionnel

The previous page URL if exists

totalintegerRequis

The total paginated items

get

/organizations/

HTTPcURLJavaScriptPython

GET /api/1/organizations/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

{
  "data": [
    {
      "acronym": "text",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "business_number_id": "text",
      "created_at": "2026-03-07T01:16:46.110Z",
      "deleted": "2026-03-07T01:16:46.110Z",
      "description": "text",
      "extras": {},
      "id": "text",
      "last_modified": "2026-03-07T01:16:46.110Z",
      "logo": "text",
      "logo_thumbnail": "text",
      "members": [
        {
          "label": "text",
          "role": "admin",
          "since": "2026-03-07T01:16:46.110Z",
          "user": {
            "class": "text",
            "id": "text",
            "avatar": "text",
            "avatar_thumbnail": "text",
            "first_name": "text",
            "last_name": "text",
            "page": "text",
            "slug": "text",
            "uri": "text",
            "email": {},
            "last_login_at": {}
          }
        }
      ],
      "metrics": {},
      "name": "text",
      "page": "text",
      "permissions": {
        "delete": true,
        "edit": true,
        "harvest": true,
        "members": true,
        "private": true
      },
      "slug": "text",
      "uri": "text",
      "url": "text"
    }
  ],
  "next_page": "text",
  "page": 1,
  "page_size": 1,
  "previous_page": "text",
  "total": 1
}

Create a new organization

post

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Corps

application/json

acronymstringOptionnel

The organization acronym

business_number_idstringOptionnel

The organization's business identification number.

created_atstring · date-timeLecture seuleOptionnel

The organization creation date

deletedstring · date-timeLecture seuleOptionnel

The organization deletion date if deleted

descriptionstring · markdownRequis

The organization description in Markdown

extrasobjectOptionnel

Extras attributes as key-value pairs

idstringLecture seuleOptionnel

The organization identifier

last_modifiedstring · date-timeLecture seuleOptionnel

The organization last modification date

logostringOptionnel

The organization logo URL

logo_thumbnailstringOptionnel

The organization logo thumbnail URL. This is the square (100x100) and cropped version.

metricsobjectLecture seuleOptionnel

The organization metrics

namestringRequis

The organization name

pagestringLecture seuleOptionnel

The organization web page URL

slugstringLecture seuleOptionnel

The organization string used as permalink

uristringLecture seuleOptionnel

The API URI for this organization

urlstringOptionnel

The organization website URL

Réponses

201

Success

application/json

400

Validation error

post

/organizations/

HTTPcURLJavaScriptPython

POST /api/1/organizations/ HTTP/1.1
Host: www.data.gouv.fr
Content-Type: application/json
Accept: */*
Content-Length: 251

{
  "acronym": "text",
  "business_number_id": "text",
  "description": "text",
  "extras": {},
  "logo": "text",
  "logo_thumbnail": "text",
  "members": [
    {
      "role": "admin",
      "user": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text"
      }
    }
  ],
  "name": "text",
  "url": "text"
}

{
  "acronym": "text",
  "badges": [
    {
      "kind": "text"
    }
  ],
  "business_number_id": "text",
  "created_at": "2026-03-07T01:16:46.110Z",
  "deleted": "2026-03-07T01:16:46.110Z",
  "description": "text",
  "extras": {},
  "id": "text",
  "last_modified": "2026-03-07T01:16:46.110Z",
  "logo": "text",
  "logo_thumbnail": "text",
  "members": [
    {
      "label": "text",
      "role": "admin",
      "since": "2026-03-07T01:16:46.110Z",
      "user": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text",
        "email": {},
        "last_login_at": {}
      }
    }
  ],
  "metrics": {},
  "name": "text",
  "page": "text",
  "permissions": {
    "delete": true,
    "edit": true,
    "harvest": true,
    "members": true,
    "private": true
  },
  "slug": "text",
  "uri": "text",
  "url": "text"
}

List all available organization badges and their labels

get

Réponses

200

Success

Aucun contenu

get

/organizations/badges/

HTTPcURLJavaScriptPython

GET /api/1/organizations/badges/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

Aucun contenu

List all possible organization roles

get

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

idstringOptionnel

The role identifier

labelstringOptionnel

The role label

get

/organizations/roles/

HTTPcURLJavaScriptPython

GET /api/1/organizations/roles/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

[
  {
    "id": "text",
    "label": "text"
  }
]

Organizations suggest endpoint using mongoDB contains

get

Paramètres de requête

qstringRequis

The string to autocomplete/suggest

sizeintegerOptionnel

The amount of suggestion to fetch

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

acronymstringLecture seuleOptionnel

The organization acronym

idstringLecture seuleOptionnel

The organization identifier

image_urlstringLecture seuleOptionnel

The organization logo URL

namestringLecture seuleOptionnel

The organization name

pagestringLecture seuleOptionnel

The organization web page URL

slugstringLecture seuleOptionnel

The organization permalink string

get

/organizations/suggest/

HTTPcURLJavaScriptPython

GET /api/1/organizations/suggest/?q=text HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

[
  {
    "acronym": "text",
    "id": "text",
    "image_url": "text",
    "name": "text",
    "page": "text",
    "slug": "text"
  }
]

List all followers for a given object

get

Paramètres de chemin

idstringRequis

Paramètres de requête

pageintegerOptionnel

The page to fetch

page_sizeintegerOptionnel

The page size to fetch

userstringOptionnel

Filter follower by user, it allows to check if a user is following the object

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

next_pagestringOptionnel

The next page URL if exists

pageinteger · min: 1Requis

The current page

page_sizeintegerRequis

The page size used for pagination

previous_pagestringOptionnel

The previous page URL if exists

totalintegerRequis

The total paginated items

get

/organizations/{id}/followers/

HTTPcURLJavaScriptPython

GET /api/1/organizations/{id}/followers/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

{
  "data": [
    {
      "follower": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      },
      "id": "text",
      "since": "2026-03-07T01:16:46.110Z"
    }
  ],
  "next_page": "text",
  "page": 1,
  "page_size": 1,
  "previous_page": "text",
  "total": 1
}

Follow an object given its ID

post

Returns the number of followers left after the operation

Paramètres de chemin

idstringRequis

Réponses

200

Success

Aucun contenu

post

/organizations/{id}/followers/

HTTPcURLJavaScriptPython

POST /api/1/organizations/{id}/followers/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

Aucun contenu

Unfollow an object given its ID

delete

Returns the number of followers left after the operation

Paramètres de chemin

idstringRequis

Réponses

200

Success

Aucun contenu

delete

/organizations/{id}/followers/

HTTPcURLJavaScriptPython

DELETE /api/1/organizations/{id}/followers/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

Aucun contenu

Get a organization given its identifier

get

Paramètres de chemin

orgstringRequis

The organization ID or slug

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

acronymstringOptionnel

The organization acronym

business_number_idstringOptionnel

The organization's business identification number.

created_atstring · date-timeLecture seuleOptionnel

The organization creation date

deletedstring · date-timeLecture seuleOptionnel

The organization deletion date if deleted

descriptionstring · markdownRequis

The organization description in Markdown

extrasobjectOptionnel

Extras attributes as key-value pairs

idstringLecture seuleOptionnel

The organization identifier

last_modifiedstring · date-timeLecture seuleOptionnel

The organization last modification date

logostringOptionnel

The organization logo URL

logo_thumbnailstringOptionnel

The organization logo thumbnail URL. This is the square (100x100) and cropped version.

metricsobjectLecture seuleOptionnel

The organization metrics

namestringRequis

The organization name

pagestringLecture seuleOptionnel

The organization web page URL

slugstringLecture seuleOptionnel

The organization string used as permalink

uristringLecture seuleOptionnel

The API URI for this organization

urlstringOptionnel

The organization website URL

404

Organization not found

410

Organization has been deleted

get

/organizations/{org}/

HTTPcURLJavaScriptPython

GET /api/1/organizations/{org}/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

{
  "acronym": "text",
  "badges": [
    {
      "kind": "text"
    }
  ],
  "business_number_id": "text",
  "created_at": "2026-03-07T01:16:46.110Z",
  "deleted": "2026-03-07T01:16:46.110Z",
  "description": "text",
  "extras": {},
  "id": "text",
  "last_modified": "2026-03-07T01:16:46.110Z",
  "logo": "text",
  "logo_thumbnail": "text",
  "members": [
    {
      "label": "text",
      "role": "admin",
      "since": "2026-03-07T01:16:46.110Z",
      "user": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text",
        "email": {},
        "last_login_at": {}
      }
    }
  ],
  "metrics": {},
  "name": "text",
  "page": "text",
  "permissions": {
    "delete": true,
    "edit": true,
    "harvest": true,
    "members": true,
    "private": true
  },
  "slug": "text",
  "uri": "text",
  "url": "text"
}

Update a organization given its identifier

put

Paramètres de chemin

orgstringRequis

The organization ID or slug

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Corps

application/json

acronymstringOptionnel

The organization acronym

business_number_idstringOptionnel

The organization's business identification number.

created_atstring · date-timeLecture seuleOptionnel

The organization creation date

deletedstring · date-timeLecture seuleOptionnel

The organization deletion date if deleted

descriptionstring · markdownRequis

The organization description in Markdown

extrasobjectOptionnel

Extras attributes as key-value pairs

idstringLecture seuleOptionnel

The organization identifier

last_modifiedstring · date-timeLecture seuleOptionnel

The organization last modification date

logostringOptionnel

The organization logo URL

logo_thumbnailstringOptionnel

The organization logo thumbnail URL. This is the square (100x100) and cropped version.

metricsobjectLecture seuleOptionnel

The organization metrics

namestringRequis

The organization name

pagestringLecture seuleOptionnel

The organization web page URL

slugstringLecture seuleOptionnel

The organization string used as permalink

uristringLecture seuleOptionnel

The API URI for this organization

urlstringOptionnel

The organization website URL

Réponses

200

Success

application/json

acronymstringOptionnel

The organization acronym

business_number_idstringOptionnel

The organization's business identification number.

created_atstring · date-timeLecture seuleOptionnel

The organization creation date

deletedstring · date-timeLecture seuleOptionnel

The organization deletion date if deleted

descriptionstring · markdownRequis

The organization description in Markdown

extrasobjectOptionnel

Extras attributes as key-value pairs

idstringLecture seuleOptionnel

The organization identifier

last_modifiedstring · date-timeLecture seuleOptionnel

The organization last modification date

logostringOptionnel

The organization logo URL

logo_thumbnailstringOptionnel

The organization logo thumbnail URL. This is the square (100x100) and cropped version.

metricsobjectLecture seuleOptionnel

The organization metrics

namestringRequis

The organization name

pagestringLecture seuleOptionnel

The organization web page URL

slugstringLecture seuleOptionnel

The organization string used as permalink

uristringLecture seuleOptionnel

The API URI for this organization

urlstringOptionnel

The organization website URL

400

Validation error: your data cannot be updated for now, we have been notified of the error and we will fix it as soon as possible.

403

Error occuring when the user does not have the required permissions

application/json

404

Organization not found

410

Organization has been deleted

put

/organizations/{org}/

HTTPcURLJavaScriptPython

PUT /api/1/organizations/{org}/ HTTP/1.1
Host: www.data.gouv.fr
Content-Type: application/json
Accept: */*
Content-Length: 251

{
  "acronym": "text",
  "business_number_id": "text",
  "description": "text",
  "extras": {},
  "logo": "text",
  "logo_thumbnail": "text",
  "members": [
    {
      "role": "admin",
      "user": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text"
      }
    }
  ],
  "name": "text",
  "url": "text"
}

{
  "acronym": "text",
  "badges": [
    {
      "kind": "text"
    }
  ],
  "business_number_id": "text",
  "created_at": "2026-03-07T01:16:46.110Z",
  "deleted": "2026-03-07T01:16:46.110Z",
  "description": "text",
  "extras": {},
  "id": "text",
  "last_modified": "2026-03-07T01:16:46.110Z",
  "logo": "text",
  "logo_thumbnail": "text",
  "members": [
    {
      "label": "text",
      "role": "admin",
      "since": "2026-03-07T01:16:46.110Z",
      "user": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text",
        "email": {},
        "last_login_at": {}
      }
    }
  ],
  "metrics": {},
  "name": "text",
  "page": "text",
  "permissions": {
    "delete": true,
    "edit": true,
    "harvest": true,
    "members": true,
    "private": true
  },
  "slug": "text",
  "uri": "text",
  "url": "text"
}

Delete a organization given its identifier

delete

Paramètres de chemin

orgstringRequis

The organization ID or slug

Paramètres de requête

send_legal_noticebooleanOptionnel

Send formal legal notice with appeal information to owner (admin only)

Réponses

204

Organization deleted

404

Organization not found

410

Organization has been deleted

delete

/organizations/{org}/

HTTPcURLJavaScriptPython

DELETE /api/1/organizations/{org}/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

Aucun contenu

Create a new badge for a given organization

post

Paramètres de chemin

orgstringRequis

The organization ID or slug

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Corps

application/json

kindstringRequis

Kind of badge (certified, etc), specific to each model

Réponses

200

Success

application/json

kindstringRequis

Kind of badge (certified, etc), specific to each model

post

/organizations/{org}/badges/

HTTPcURLJavaScriptPython

POST /api/1/organizations/{org}/badges/ HTTP/1.1
Host: www.data.gouv.fr
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "kind": "text"
}

200

Success

{
  "kind": "text"
}

Delete a badge for a given organization

delete

Paramètres de chemin

badge_kindstringRequis

orgstringRequis

The organization ID or slug

Réponses

200

Success

Aucun contenu

delete

/organizations/{org}/badges/{badge_kind}/

HTTPcURLJavaScriptPython

DELETE /api/1/organizations/{org}/badges/{badge_kind}/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

Aucun contenu

get

Paramètres de chemin

orgstringRequis

The organization ID or slug

Réponses

404

Organization not found

410

Organization has been deleted

get

/organizations/{org}/catalog

HTTPcURLJavaScriptPython

GET /api/1/organizations/{org}/catalog HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

Aucun contenu

List organization datasets (including private ones when member)

get

Paramètres de chemin

orgstringRequis

Paramètres de requête

qstringOptionnel

The search query

sortstring · enumOptionnel

The field (and direction) on which sorting apply

Valeurs possibles:

pageintegerOptionnel

The page to display

page_sizeintegerOptionnel

The page size

tagstring[]Optionnel

licensestringOptionnel

featuredbooleanOptionnel

If set to true, it will filter on featured datasets only. If set to false, it will exclude featured datasets.

geozonestringOptionnel

granularitystringOptionnel

temporal_coveragestringOptionnel

organizationstringOptionnel

badgestring · enumOptionnelValeurs possibles:

organization_badgestring · enumOptionnelValeurs possibles:

ownerstringOptionnel

followed_bystringOptionnel

(beta, subject to change/be removed)

formatstringOptionnel

schemastringOptionnel

schema_versionstringOptionnel

topicstringOptionnel

creditstringOptionnel

dataservicestringOptionnel

reusestringOptionnel

archivedbooleanOptionnel

If set to true, it will filter on archived datasets only. If set to false, it will exclude archived datasets. User must be authenticated and results are limited to user visibility

deletedbooleanOptionnel

If set to true, it will filter on deleted datasets only. If set to false, it will exclude deleted datasets. User must be authenticated and results are limited to user visibility

privatebooleanOptionnel

If set to true, it will filter on private datasets only. If set to false, it will exclude private datasets. User must be authenticated and results are limited to user visibility

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

next_pagestringOptionnel

The next page URL if exists

pageinteger · min: 1Requis

The current page

page_sizeintegerRequis

The page size used for pagination

previous_pagestringOptionnel

The previous page URL if exists

totalintegerRequis

The total paginated items

get

/organizations/{org}/datasets/

HTTPcURLJavaScriptPython

GET /api/1/organizations/{org}/datasets/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

{
  "data": [
    {
      "access_audiences": [
        {
          "condition": "yes",
          "role": "local_authority_and_administration"
        }
      ],
      "access_type": "open",
      "access_type_reason": "text",
      "access_type_reason_category": "confidentiality_of_proceedings_of_public_authorities",
      "acronym": "text",
      "archived": "2026-03-07T01:16:46.110Z",
      "authorization_request_url": "text",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "contact_points": [
        "text"
      ],
      "created_at_internal": "2026-03-07T01:16:46.110Z",
      "deleted": "2026-03-07T01:16:46.110Z",
      "description": "text",
      "description_short": "text",
      "ext": {},
      "extras": {},
      "featured": true,
      "frequency": "continuous",
      "frequency_date": "2026-03-07T01:16:46.110Z",
      "harvest": {},
      "id": "text",
      "last_modified_internal": "2026-03-07T01:16:46.110Z",
      "last_update": "2026-03-07T01:16:46.110Z",
      "license": "text",
      "metrics": {},
      "organization": {
        "class": "text",
        "id": "text",
        "acronym": "text",
        "badges": [
          {
            "kind": "text"
          }
        ],
        "logo": "text",
        "logo_thumbnail": "text",
        "name": "text",
        "page": "text",
        "permissions": {
          "delete": true,
          "edit": true,
          "harvest": true,
          "members": true,
          "private": true
        },
        "slug": "text",
        "uri": "text"
      },
      "owner": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      },
      "private": true,
      "quality_cached": {},
      "resources": [
        {
          "metrics": {}
        }
      ],
      "schema": {},
      "slug": "text",
      "spatial": {
        "geom": {
          "coordinates": [
            {}
          ],
          "type": "Point"
        },
        "granularity": "other",
        "zones": {}
      },
      "tags": [
        "text"
      ],
      "temporal_coverage": {
        "end": "2026-03-07T01:16:46.110Z",
        "start": "2026-03-07T01:16:46.110Z"
      },
      "title": "text"
    }
  ],
  "next_page": "text",
  "page": 1,
  "page_size": 1,
  "previous_page": "text",
  "total": 1
}

List organization discussions

get

Paramètres de chemin

orgstringRequis

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

classstringRequis

The object class

closedstring · date-timeOptionnel

The discussion closing date

createdstring · date-timeOptionnel

The discussion creation date

extrasobjectOptionnel

Extra attributes as key-value pairs

idstringOptionnel

The discussion identifier

self_web_urlstringOptionnel

The discussion web URL

titlestringOptionnel

The discussion title

urlstringOptionnel

The discussion API URI

get

/organizations/{org}/discussions/

HTTPcURLJavaScriptPython

GET /api/1/organizations/{org}/discussions/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

[
  {
    "class": "text",
    "closed": "2026-03-07T01:16:46.110Z",
    "closed_by": {
      "class": "text",
      "id": "text",
      "avatar": "text",
      "avatar_thumbnail": "text",
      "first_name": "text",
      "last_name": "text",
      "page": "text",
      "slug": "text",
      "uri": "text"
    },
    "closed_by_organization": {
      "class": "text",
      "id": "text",
      "acronym": "text",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "logo": "text",
      "logo_thumbnail": "text",
      "name": "text",
      "page": "text",
      "permissions": {
        "delete": true,
        "edit": true,
        "harvest": true,
        "members": true,
        "private": true
      },
      "slug": "text",
      "uri": "text"
    },
    "created": "2026-03-07T01:16:46.110Z",
    "discussion": {
      "content": "text",
      "id": "text",
      "last_modified_at": "2026-03-07T01:16:46.110Z",
      "permissions": {
        "delete": true,
        "edit": true
      },
      "posted_by": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      },
      "posted_by_organization": {
        "class": "text",
        "id": "text",
        "acronym": "text",
        "badges": [
          {
            "kind": "text"
          }
        ],
        "logo": "text",
        "logo_thumbnail": "text",
        "name": "text",
        "page": "text",
        "permissions": {
          "delete": true,
          "edit": true,
          "harvest": true,
          "members": true,
          "private": true
        },
        "slug": "text",
        "uri": "text"
      },
      "posted_on": "2026-03-07T01:16:46.110Z",
      "spam": {
        "status": "not_checked"
      }
    },
    "extras": {},
    "id": "text",
    "organization": {
      "class": "text",
      "id": "text",
      "acronym": "text",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "logo": "text",
      "logo_thumbnail": "text",
      "name": "text",
      "page": "text",
      "permissions": {
        "delete": true,
        "edit": true,
        "harvest": true,
        "members": true,
        "private": true
      },
      "slug": "text",
      "uri": "text"
    },
    "permissions": {
      "close": true,
      "delete": true,
      "edit": true
    },
    "self_web_url": "text",
    "spam": {
      "status": "not_checked"
    },
    "subject": {
      "class": "text",
      "id": "text"
    },
    "title": "text",
    "url": "text",
    "user": {
      "class": "text",
      "id": "text",
      "avatar": "text",
      "avatar_thumbnail": "text",
      "first_name": "text",
      "last_name": "text",
      "page": "text",
      "slug": "text",
      "uri": "text"
    }
  }
]

List membership requests for a given organization

get

Paramètres de chemin

orgstringRequis

The organization ID or slug

Paramètres de requête

statusstringOptionnel

If provided, only return requests in a given status

userstringOptionnel

If provided, only return requests for this user

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

commentstringOptionnel

A request comment from the user

createdstring · date-timeLecture seuleOptionnel

The request creation date

emailstringOptionnel

Email for non-registered user invitations

idstringLecture seuleOptionnel

kindstring · enumOptionnel

The request kind (request or invitation)

Default: requestExample: requestValeurs possibles:

rolestring · enumOptionnel

The role to assign

Default: editorExample: adminValeurs possibles:

statusstring · enumRequis

The current request status

Example: pendingValeurs possibles:

403

Not Authorized

get

/organizations/{org}/membership/

HTTPcURLJavaScriptPython

GET /api/1/organizations/{org}/membership/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

[
  {
    "comment": "text",
    "created": "2026-03-07T01:16:46.110Z",
    "email": "text",
    "id": "text",
    "kind": "request",
    "role": "admin",
    "status": "pending",
    "user": {
      "class": "text",
      "id": "text",
      "avatar": "text",
      "avatar_thumbnail": "text",
      "first_name": "text",
      "last_name": "text",
      "page": "text",
      "slug": "text",
      "uri": "text",
      "email": {},
      "last_login_at": {}
    }
  }
]

Apply for membership to a given organization

post

Paramètres de chemin

orgstringRequis

The organization ID or slug

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

commentstringOptionnel

A request comment from the user

createdstring · date-timeLecture seuleOptionnel

The request creation date

emailstringOptionnel

Email for non-registered user invitations

idstringLecture seuleOptionnel

kindstring · enumOptionnel

The request kind (request or invitation)

Default: requestExample: requestValeurs possibles:

rolestring · enumOptionnel

The role to assign

Default: editorExample: adminValeurs possibles:

statusstring · enumRequis

The current request status

Example: pendingValeurs possibles:

post

/organizations/{org}/membership/

HTTPcURLJavaScriptPython

POST /api/1/organizations/{org}/membership/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

{
  "comment": "text",
  "created": "2026-03-07T01:16:46.110Z",
  "email": "text",
  "id": "text",
  "kind": "request",
  "role": "admin",
  "status": "pending",
  "user": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "first_name": "text",
    "last_name": "text",
    "page": "text",
    "slug": "text",
    "uri": "text",
    "email": {},
    "last_login_at": {}
  }
}

Accept user membership to a given organization

post

Paramètres de chemin

idstringRequis

orgstringRequis

The organization ID or slug

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

labelstringLecture seuleOptionnel

rolestring · enumRequis

The member role in the organization

Default: editorExample: adminValeurs possibles:

sincestring · date-timeLecture seuleOptionnel

The date the user joined the organization

post

/organizations/{org}/membership/{id}/accept/

HTTPcURLJavaScriptPython

POST /api/1/organizations/{org}/membership/{id}/accept/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

{
  "label": "text",
  "role": "admin",
  "since": "2026-03-07T01:16:46.110Z",
  "user": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "first_name": "text",
    "last_name": "text",
    "page": "text",
    "slug": "text",
    "uri": "text",
    "email": {},
    "last_login_at": {}
  }
}

Refuse user membership to a given organization

post

Paramètres de chemin

idstringRequis

orgstringRequis

The organization ID or slug

Corps

application/json

commentstringOptionnel

The refusal comment.

Réponses

200

Success

Aucun contenu

post

/organizations/{org}/membership/{id}/refuse/

HTTPcURLJavaScriptPython

POST /api/1/organizations/{org}/membership/{id}/refuse/ HTTP/1.1
Host: www.data.gouv.fr
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "comment": "text"
}

200

Success

Aucun contenu

List organization reuses (including private ones when member)

get

Paramètres de chemin

orgstringRequis

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

archivedstring · date-timeOptionnel

created_atstring · date-timeLecture seuleRequis

deletedstring · date-timeOptionnel

descriptionstring · markdownRequis

extrasobjectOptionnel

featuredbooleanLecture seuleOptionnel

idstringLecture seuleRequis

imagestringLecture seuleOptionnel

URL of the image

image_thumbnailstringLecture seuleOptionnel

URL of the cropped and squared image (500x500)

last_modifiedstring · date-timeLecture seuleRequis

metricsobjectLecture seuleOptionnel

pagestringLecture seuleOptionnel

Link to the udata web page for this reuse

privatebooleanOptionnel

slugstring · max: 255Lecture seuleRequis

tagsstring[]Optionnel

titlestringRequis

topicstring · enumRequisExample: healthValeurs possibles:

typestring · enumRequisExample: apiValeurs possibles:

uristringLecture seuleOptionnel

Link to the API endpoint for this reuse

urlstringRequis

The remote URL (website)

get

/organizations/{org}/reuses/

HTTPcURLJavaScriptPython

GET /api/1/organizations/{org}/reuses/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

[
  {
    "archived": "2026-03-07T01:16:46.110Z",
    "badges": [
      {
        "kind": "text"
      }
    ],
    "created_at": "2026-03-07T01:16:46.110Z",
    "dataservices": [
      {
        "class": "text",
        "id": "text",
        "self_api_url": "text",
        "self_web_url": "text",
        "title": "My awesome API"
      }
    ],
    "datasets": [
      {
        "access_audiences": [
          {
            "condition": "yes",
            "role": "local_authority_and_administration"
          }
        ],
        "access_type": "text",
        "access_type_reason": "text",
        "access_type_reason_category": "text",
        "acronym": "text",
        "archived": "2026-03-07T01:16:46.110Z",
        "authorization_request_url": "text",
        "badges": [
          {
            "kind": "text"
          }
        ],
        "community_resources": [
          {
            "checksum": {
              "type": "sha1",
              "value": "text"
            },
            "created_at": "2026-03-07T01:16:46.110Z",
            "description": "text",
            "extras": {},
            "filesize": 1,
            "filetype": "file",
            "format": "text",
            "harvest": {
              "issued_at": "2026-03-07T01:16:46.110Z",
              "modified_at": "2026-03-07T01:16:46.110Z",
              "uri": "text"
            },
            "id": "text",
            "internal": {
              "created_at_internal": "2026-03-07T01:16:46.110Z",
              "last_modified_internal": "2026-03-07T01:16:46.110Z"
            },
            "last_modified": "2026-03-07T01:16:46.110Z",
            "latest": "text",
            "metrics": {},
            "mime": "text",
            "preview_url": "text",
            "schema": {
              "name": "text",
              "url": "text",
              "version": "text"
            },
            "title": "text",
            "type": "main",
            "url": "text",
            "dataset": {
              "class": "text",
              "id": "text"
            },
            "organization": {
              "class": "text",
              "id": "text",
              "acronym": "text",
              "badges": [
                {
                  "kind": "text"
                }
              ],
              "logo": "text",
              "logo_thumbnail": "text",
              "name": "text",
              "page": "text",
              "permissions": {
                "delete": true,
                "edit": true,
                "harvest": true,
                "members": true,
                "private": true
              },
              "slug": "text",
              "uri": "text"
            },
            "owner": {
              "class": "text",
              "id": "text",
              "avatar": "text",
              "avatar_thumbnail": "text",
              "first_name": "text",
              "last_name": "text",
              "page": "text",
              "slug": "text",
              "uri": "text"
            },
            "permissions": {
              "delete": true,
              "edit": true,
              "edit_resources": true
            }
          }
        ],
        "contact_points": [
          {
            "contact_form": "text",
            "email": "text",
            "id": "text",
            "name": "text",
            "organization": {
              "class": "text",
              "id": "text",
              "acronym": "text",
              "badges": [
                {
                  "kind": "text"
                }
              ],
              "logo": "text",
              "logo_thumbnail": "text",
              "name": "text",
              "page": "text",
              "permissions": {
                "delete": true,
                "edit": true,
                "harvest": true,
                "members": true,
                "private": true
              },
              "slug": "text",
              "uri": "text"
            },
            "owner": {
              "class": "text",
              "id": "text",
              "avatar": "text",
              "avatar_thumbnail": "text",
              "first_name": "text",
              "last_name": "text",
              "page": "text",
              "slug": "text",
              "uri": "text"
            },
            "role": "text"
          }
        ],
        "created_at": "2026-03-07T01:16:46.110Z",
        "deleted": "2026-03-07T01:16:46.110Z",
        "description": "text",
        "description_short": "text",
        "extras": {},
        "featured": true,
        "frequency": "continuous",
        "frequency_date": "2026-03-07T01:16:46.110Z",
        "harvest": {
          "archived": "text",
          "archived_at": "2026-03-07T01:16:46.110Z",
          "backend": "text",
          "created_at": "2026-03-07T01:16:46.110Z",
          "dct_identifier": "text",
          "domain": "text",
          "issued_at": "2026-03-07T01:16:46.110Z",
          "last_update": "2026-03-07T01:16:46.110Z",
          "modified_at": "2026-03-07T01:16:46.110Z",
          "remote_id": "text",
          "remote_url": "text",
          "source_id": "text",
          "uri": "text"
        },
        "id": "text",
        "internal": {
          "created_at_internal": "2026-03-07T01:16:46.110Z",
          "last_modified_internal": "2026-03-07T01:16:46.110Z"
        },
        "last_modified": "2026-03-07T01:16:46.110Z",
        "last_update": "2026-03-07T01:16:46.110Z",
        "license": "notspecified",
        "metrics": {},
        "organization": {
          "class": "text",
          "id": "text",
          "acronym": "text",
          "badges": [
            {
              "kind": "text"
            }
          ],
          "logo": "text",
          "logo_thumbnail": "text",
          "name": "text",
          "page": "text",
          "permissions": {
            "delete": true,
            "edit": true,
            "harvest": true,
            "members": true,
            "private": true
          },
          "slug": "text",
          "uri": "text"
        },
        "owner": {
          "class": "text",
          "id": "text",
          "avatar": "text",
          "avatar_thumbnail": "text",
          "first_name": "text",
          "last_name": "text",
          "page": "text",
          "slug": "text",
          "uri": "text"
        },
        "page": "text",
        "permissions": {
          "delete": true,
          "edit": true,
          "edit_resources": true
        },
        "private": true,
        "quality": {},
        "resources": [
          {
            "checksum": {
              "type": "sha1",
              "value": "text"
            },
            "created_at": "2026-03-07T01:16:46.110Z",
            "description": "text",
            "extras": {},
            "filesize": 1,
            "filetype": "file",
            "format": "text",
            "harvest": {
              "issued_at": "2026-03-07T01:16:46.110Z",
              "modified_at": "2026-03-07T01:16:46.110Z",
              "uri": "text"
            },
            "id": "text",
            "internal": {
              "created_at_internal": "2026-03-07T01:16:46.110Z",
              "last_modified_internal": "2026-03-07T01:16:46.110Z"
            },
            "last_modified": "2026-03-07T01:16:46.110Z",
            "latest": "text",
            "metrics": {},
            "mime": "text",
            "preview_url": "text",
            "schema": {
              "name": "text",
              "url": "text",
              "version": "text"
            },
            "title": "text",
            "type": "main",
            "url": "text"
          }
        ],
        "schema": {
          "name": "text",
          "url": "text",
          "version": "text"
        },
        "slug": "text",
        "spatial": {
          "geom": {
            "coordinates": [
              {}
            ],
            "type": "Point"
          },
          "granularity": "other",
          "zones": {}
        },
        "tags": [
          "text"
        ],
        "temporal_coverage": {
          "end": "2026-03-07T01:16:46.110Z",
          "start": "2026-03-07T01:16:46.110Z"
        },
        "title": "text",
        "uri": "text"
      }
    ],
    "deleted": "2026-03-07T01:16:46.110Z",
    "description": "text",
    "extras": {},
    "featured": true,
    "id": "text",
    "image": "text",
    "image_thumbnail": "text",
    "last_modified": "2026-03-07T01:16:46.110Z",
    "metrics": {},
    "organization": {
      "class": "text",
      "id": "text",
      "acronym": "text",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "logo": "text",
      "logo_thumbnail": "text",
      "name": "text",
      "page": "text",
      "permissions": {
        "delete": true,
        "edit": true,
        "harvest": true,
        "members": true,
        "private": true
      },
      "slug": "text",
      "uri": "text"
    },
    "owner": {
      "class": "text",
      "id": "text",
      "avatar": "text",
      "avatar_thumbnail": "text",
      "first_name": "text",
      "last_name": "text",
      "page": "text",
      "slug": "text",
      "uri": "text"
    },
    "page": "text",
    "permissions": {
      "delete": true,
      "edit": true
    },
    "private": true,
    "slug": "text",
    "tags": [
      "text"
    ],
    "title": "text",
    "topic": "health",
    "type": "api",
    "uri": "text",
    "url": "text"
  }
]