--- title: "List Organizations" method: GET path: "/organizations" tags: ["Organizations"] --- # List Organizations `GET /organizations` ## Request - Base URL: `https://api.mediamath.com/api/v3.0` - URL: `https://api.mediamath.com/api/v3.0/organizations` - Auth: OAuth 2 - Authorization code: `https://auth.mediamath.com/authorize` - Token URL: `https://auth.mediamath.com/oauth/token` scopes: `offline_access`, `manage:services` - TypeScript: (a function with typed inputs; its response is checked against the schema) Get a list of organizations ## Query parameters - `page_limit` integer - `page_offset` integer - `sort_by` string - `q` string - `full` string ## Response `200` List organizations response - union - OrganizationCollection - `data` object[] - `id` integer - `name` string - `entity_type` string - `meta` ListMetadata - `status` string, required: The status of the response, indicating success or failure. - `count` integer, required: The number of items returned in the current response. - `total_count` integer: The total number of items available in the dataset. - `offset` integer: The offset from the start of the dataset, used for pagination. - `next_page` string: The URL to fetch the next page of results. - `prev_page` string: The URL to fetch the previous page of results. - OrganizationResponse - `data` object - `name` string, required: The name of the organization with whom the contract is held. This can be an agency holding company, agency, advertiser, network, or other media or data buying entity. - `org_type` string[]: The `org_type` field is an array that specifies the type of organization. - `status` boolean, required - `website` string, nullable - `facebook` string, nullable - `linkedin` string, nullable - `twitter` string, nullable - `allow_x_agency_pixels` boolean: This field enables the Data Co-op functionality across all the Advertisers under this organization. Cross-Advertiser Pixel Targeting allows Advertisers to target other Advertiser Event Pixels within their Agency and any other similarly enabled Agency under the same Organization. - `allow_byo_price` boolean - `opt_out_connected_id` boolean - `opt_out_connected_id_mathid` boolean - `override_suspicious_traffic_filter` boolean: Set flag to 'on’ to be able to override default org wide suspicious traffic filter level. - `restrict_targeting_to_same_device_id` boolean - `restrict_targeting_to_deterministic_id` boolean - `suspicious_traffic_filter_level` integer: Specify an organization-wide level of suspicious traffic filtering to use. See the Knowledge Base for additional details about this feature. This setting will only take affect if the organization's override_suspicious_traffic_filter property is set to 'on'. If override_suspicious_traffic_filter is enabled and suspicious_traffic_filter_level is set to 0, all fraud and suspicious traffic will be filtered. - `use_ads_txt` boolean - `use_evidon_optout` boolean, nullable: Set flag to 'on’ to show an opt out button on the organization's ads (additional CPM fee will apply when on). - `eligible_for_data_sharing` boolean - `holding_org_id` integer, nullable - `service_provider_ccpa` boolean - `mfa_avoidance` 'ALLOW_ALL' | 'EXCLUDE_MFA' - `mm_contact_name` string, required: This is the name of the primary internal MediaMath contact of the Organization. - `adx_seat_account_id` integer, required: Passed to ADX upon creative registration so ADX knows which seat we're registering under. - `connected_id_type` 'DETERMINISTIC_FIRST', required - `contact_name` string, required: This is the primary contact at the organization regarding contract issues. - `address_1` string, required: The primary address line, typically includes street address and number. - `address_2` string, nullable: The secondary address line, used for additional information such as apartment, suite, or unit number. - `city` string, required: The city of the address. - `state` string, required: The state of the address, represented as a 2-character code. - `zip` string, required: The postal or ZIP code for the address. - `country` string, required: The country of the address, represented as a 2-character ISO country code. - `phone` string, required: The phone number associated with the address, including country code if applicable. - `currency_code` string, required: Currency code for the campaign budget and spend, as well as billing. - `billing_country_code` string, required: Country code that is used for billing purposes. - `dmp_enabled` 'enabled' | 'disabled', required - `seats` object[], nullable - `supply_source_id` integer, required - `seat_identifier` string, required - `bill_media_to_client` boolean, nullable - `rmx_exchange_cost_unit` string, nullable - `rmx_exchange_cost_cpm` number, float, nullable - `rmx_exchange_cost_pct` number, float, nullable - `status` boolean, nullable - `data` object - `supply_source_id` integer, required - `seat_identifier` string, required - `bill_media_to_client` boolean, nullable - `rmx_exchange_cost_unit` string, nullable - `rmx_exchange_cost_cpm` number, float, nullable - `rmx_exchange_cost_pct` number, float, nullable - `status` boolean, nullable - `id` integer - `version` integer - `created_on` string, date-time - `updated_on` string, date-time - `mcp_enabled` boolean: Controls whether the organization is permitted to access the platform via MCP (Model Context Protocol) tooling. - `mcp_access_level` 'read_only' | 'read_write': Determines the scope of MCP access for the organization. 'read_only' permits read/query operations only. 'read_write' permits all operations including create and update. - `inf_business_unit` string, nullable: Available only for internal users. - `environment` string, nullable: Available only for internal users. - `id` integer - `created_on` string, date-time - `entity_type` string - `terminated` boolean - `updated_on` string, date-time - `version` integer - `meta` object - `status` string ## Other responses - `400`: Error response - `401`: Error response - `403`: Error response - `404`: Error response --- [API](https://skmtc.dev/mediamath/apis/campaigns-api.md) - [All operations](https://skmtc.dev/mediamath/apis/campaigns-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mediamath/apis/campaigns-api/revisions/408743891def?raw)