v1

latestOpenAPI 3.1.0© Copyright Partoo2026-07-26163503484.0 KB
Users

User businesses

This endpoint lets you retrieve the list of businesses which the selected user has READ access to.

get/user/{user_id}/businesses

Path parameters

user_idstring required

User id

Query parameters

pageinteger

Page number. Starts at 1. Any value lower than 1 will be considered as 1. For the number of items per page, see the per_page query parameter.

per_pageinteger

Number of items to return per page. Currently limited to 100.

Response

OK

pageinteger

Current page number

max_pageinteger

Last page number

countinteger

Number of resources complying with filters

Example response

{
  "page": 1,
  "max_page": 10,
  "count": 287,
  "businesses": [
    {
      "id": "5409c35a97bbc544d8e26737",
      "created": 1409925979.5,
      "modified": 1561335111.681374,
      "code": "CS-75019",
      "status": "open",
      "org_id": 42,
      "groups": [
        1,
        2,
        3
      ],
      "name": "Corner shop",
      "address_full": "12 bis rue du coquelicot",
      "city": "Paris",
      "zipcode": "75019",
      "region": "Ile-de-France",
      "country": "FR",
      "default_lang": "fr",
      "open_hours": {
        "monday": [
          "10:00-14:00"
        ],
        "tuesday": [
          "10:00-14:00"
        ],
        "wednesday": [
          "10:00-14:00"
        ],
        "thursday": [
          "10:00-14:00"
        ],
        "friday": [
          "10:00-14:00"
        ],
        "saturday": [
          "10:00-14:00"
        ],
        "sunday": [
          "10:00-14:00"
        ]
      },
      "specific_hours": {
        "open": [
          {
            "starts_at": "2020-01-20",
            "ends_at": "2020-01-20",
            "open_hours": [
              "10:00-14:00"
            ]
          }
        ],
        "close": [
          {
            "starts_at": "2020-01-20",
            "ends_at": "2020-01-22"
          }
        ]
      },
      "description_short": "lorem ipsum",
      "description_long": "lorem ipsum dolor sit amet",
      "website_url": "https://www.corner-shop.co/",
      "facebook_url": "https://www.facebook.com/the-corner-shop",
      "twitter_url": "https://www.twitter.com/the-corner-shop",
      "contacts": [
        {
          "name": "Hubert Bonisseur de la Bath",
          "email": "hubert@oss117.fr",
          "phone_numbers": [
            "+33302060628"
          ],
          "fax": "+33302060629"
        }
      ],
      "lat": -3.585993,
      "long": 47.870341,
      "subscriptions": {
        "presence_management": {
          "active": true
        },
        "review_management": {
          "active": true
        },
        "review_booster": {
          "active": false
        },
        "messages": {
          "active": false
        }
      },
      "features": [
        "business_edition",
        "diffusion",
        "review_management",
        "review_invite",
        "messages"
      ],
      "completion_rate": 77
    }
  ]
}