List all users

Lists all users that have access to your partner account. The users are sorted by join date, with the first user to join appearing first.

Parameters


Name optional

Filters the list of users based on the provided URL-encoded string. If the provided value fully or partially matches a Firstname, Lastname, or Username, the matching user object will be returned.


State optional

Filters the list of users based on a provided enum value.

Possible enum values
ACTIVE
PENDING
INVITED

Returns


Returns a list of users that have access to your partner account based on the parameters submitted. Returns an error if an invalid enum is submitted.

Example request


curl 'https://api.impact.com/Mediapartners/<AccountSID>/Users' \
  -X GET \
  -u '<AccountSID>:<AuthToken>' \
  -H 'Accept: application/json' \
  -d 'Name=John' \
  -d 'State=ACTIVE' \
  -G

Example response


{
  "@page": "1",
   ...
  "Users": [
    {
      "Id": "I-1234567",
      "FirstName": "Wile",
      "LastName": "Coyote",
      "Username": "WileECoyote",
      "Type": "MEMBER",
      "State": "ACTIVE",
      "Language": "en_US",
      "AccessRights": [
        {
          "Role": "Creative Management",
          "Permissions": [
            "GET_AD_HTML",
            "REQUEST_CUSTOM_ADS",
            "RUN_CREATIVE_REPORTS",
            "APPROVE_CREATIVE_AND_DUB_HOUSE_EXPENSES",
            "MANAGE_CREATIVES"
          ]
        },
        {
          "Role": "Finance",
          "Permissions": [
            "MANAGE_FINANCIAL_SETTINGS",
            "VIEW_FINANCIALS",
            "RUN_FINANCIAL_TRANSACTION_REPORTS"
          ]
        },
        {
          "Role": "Advertiser Management",
          "Permissions": [
            "APPLY_TO_CAMPAIGN",
            "RUN_ACTION_AND_PERFORMANCE_REPORTS",
            "REQUEST_CAP_EXTENSIONS_AND_AGREEMENT_EXCEPTIONS",
            "NEGOTIATE_AGREEMENTS",
            "SEND_MARKETING_MSG_TO_BRAND",
            "VIEW_BRAND_INFO"
          ]
        },
        {
          "Role": "Technical",
          "Permissions": [
            "WEBSERVICES_INTEGRATION",
            "ITEM_LIST_INTEGRATIONS",
            "RUN_TECHNICAL_REPORTS",
            "TRACKER_AND_BRAND_URL_INTEGRATIONS",
            "EVENT_CALLBACK_INTEGRATION"
          ]
        },
        {
          "Role": "Account Administration",
          "Permissions": [
            "RUN_USAGE_REPORTS",
            "MANAGE_DIRECTORY_INFO",
            "MANAGE_ACCOUNT_INFO"
          ]
        }
      ],
      "JoinedDate": "2020-04-29T16:24:13-07:00",
      "DateLastUpdated": "2020-12-09T08:34:06-08:00",
      "LastUpdatedBy": "WileECoyote",
      "CreatedBy": "RoadRunner",
      "Uri": "/Mediapartners/IRMTQCr9awmz1924609yGQDbCui8EbfRN1/Users/I-2320266"
    },
    {
      ...
    }
  ]
}