---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/en/businesses/get.md
  - https://yandex.com/dev/direct/doc/ru/businesses/get.md
  - href: en/businesses/get.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/ref-v5/businesses/get.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/en/llms.txt

# get

Returns data from the user's [business profiles](https://yandex.ru/support/sprav/general/displaying.html#displaying__profile) on Yandex.
The user can get data for businesses that meet at least one of the following criteria:

- The user's [chief representative](https://yandex.com/dev/direct/doc/objects/roles.html) has [confirmed rights](https://yandex.ru/support/sprav/manage/verify.html) for the business in Yandex Business.
- The business profile is linked to one of the user's ads.

If the business profile doesn't pass moderation in Yandex Business, the `IsPublished` parameter returns NO. You won't be able to link this business profile to an ad.

### Learn more {#see-also}

- [How the "get" method works](https://yandex.com/dev/direct/doc/best-practice/get.html)


## Request {#input}

Request structure in JSON format:

```javascript translate=no
{
  "method": "get",
  "params": { /* params */
    "SelectionCriteria": {  /* IdsCriteria */
      "Ids": [(long), ... ] /* required */
    },
    "FieldNames": [( "Id" | "Name" | "Address" | "Phone"
                     | "ProfileUrl" | "InternalUrl" | "IsPublished"
                     | "MergedIds" | "Rubric" | "Urls"
                     | "HasOffice" ), ... ], /* required */
    "Page": {  /* LimitOffset */
      "Limit": (long),
      "Offset": (long)
    }
  }
}
```

#|
|| **Parameter** | **Type** | **Description** | **Required** ||

|| **params structure (for JSON) / GetRequest (for SOAP)** | > | > | > ||

|| `SelectionCriteria` | IdsCriteria | Criteria for selecting business profiles.  | No ||

|| `FieldNames` | array of BusinessFieldEnum | The names of parameters to get.  | Yes ||

|| `Page` | LimitOffset | Structure that defines the page for [paginated selection](https://yandex.com/dev/direct/doc/best-practice/get.html) of data.  | No ||

|| **IdsCriteria structure** | > | > | > ||

|| `Ids` | array of long | IDs of the requested business profiles (a maximum of 10,000).  | Yes ||
|# 


## Response {#output}

Response structure in JSON format:

```javascript translate=no
{
  "result": { /* result */
    "Businesses": [{ /* BusinessGetItem */
      "Id": (long),
      "Name": (string),
      "Address": (string), /* nillable */
      "Phone": (string),
      "ProfileUrl": (string),
      "InternalUrl": (string),
      "IsPublished": ( "YES" | "NO" ),
      "MergedIds": {  /* ArrayOfLong */
        "Items": [(long), ... ]
      },
      "Rubric": (string),
      "Urls": {  /* ArrayOfString */
        "Items": [(string), ... ]
      },
      "HasOffice": ( "YES" | "NO" )
    }, ... ],
    "LimitedBy": (long)
  }
}
```

#|
|| **Parameter** | **Type** | **Description** ||

|| **result structure (for JSON) / GetResponse (for SOAP)** | > | > ||

|| `Businesses` | array of BusinessGetItem | Business profiles.  ||

|| `LimitedBy` | long | Sequential number of the last object returned. It is included if there was a limit on the number of objects in the response. See the section [Paginated data selection](https://yandex.com/dev/direct/doc/best-practice/get.html).  ||

|| **BusinessGetItem structure** | > | > ||

|| `Id` | long | ID of the business profile.  ||

|| `Name` | string | Name of the organization.  ||

|| `Address` | string, nillable | Address of the business.  ||

|| `Phone` | string | Phone number of the business.  ||

|| `ProfileUrl` | string | Link to the business profile on Yandex.  ||

|| `InternalUrl` | string | Link to the business editing page in Yandex Business.  ||

|| `IsPublished` | YesNoEnum | Indicates that the business profile passed moderation in Yandex Business Directory and is published.

You can link a business profile to an ad only if the YES value is returned in the `IsPublished` parameter.  ||

|| `MergedIds` | ArrayOfLong | IDs of business profiles that are combined with the main profile (the ID of the main profile is specified in the `Id` field).

Only IDs of profiles linked to the user's ads are returned, and only if the request omitted `SelectionCriteria`.  ||

|| `Rubric` | string | Type of business.  ||

|| `Urls` | ArrayOfString | Links to the site and social networks.  ||

|| `HasOffice` | YesNoEnum | Indicates that the organization has a physical location.  ||
|#