> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.partnerpage.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.partnerpage.io/_mcp/server.

# Get a partner's profile by slug

GET https://v1.api.partnerpage.io/api/directory/public/v1alpha/directories/{directoryId}/entries/partners/slugs/{slug}/

Returns one partner's profile, with everything its details page shows: logo (`icon`), cover `image`, `tier`, callouts, media, filters and the filter options it has (`assignedFilterOptions`), and the directory's public profile fields it filled in (`profileFields`, by field key). No API key is needed.

Only `public` and `searchable` partners are returned. A `hidden` or `inactive` partner answers 404, like an unknown slug. When the directory reviews partner edits, this returns the last approved profile; edits waiting for review are not shown. Use the `slug` the listing returns: a custom slug replaces the original one.

Reference: https://docs.partnerpage.io/api-reference/directory/public-directory/get-a-partners-profile-by-slug

## Request

### Path parameters

- `directoryId` (string, required) — ID of the directory
- `slug` (string, required) — The partner's slug, as the listing returns it

## Response

### 200

Successful operation

- `href` (string, required)
- `id` (string, required)
- `title` (string, required)
- `headline` (string, required, nullable)
- `type` (string, required)
- `slug` (string, required)
- `customSlug` (string, required, nullable)
- `featured` (boolean, required)
- `owner` (map from string to any, required, nullable)
- `icon` (string, required, nullable)
- `image` (string, required, nullable)
- `iconDark` (string, required, nullable)
- `imageDark` (string, required, nullable)
- `callouts` (list of Public Callouts, required)
- `website` (string, required, nullable)
- `filters` (list of Public BaseFilter, required)
- `assignedFilterOptions` (list of Public FilterOption, required)
- `status` (enum, required) — * `hidden` - hidden * `inactive` - inactive * `public` - public * `searchable` - searchable
  - Allowed values: `hidden`, `inactive`, `public`, `searchable`
- `recommendedOrder` (integer, required, nullable)
- `rating` (double, required, nullable)
- `numberOfReviews` (integer, required, nullable)
- `numberOfReviewsByRating` (any, required, nullable)
- `tier` (GenericTierSlugDetailReader, required, nullable)
- `description` (string, required, nullable)
- `integrationDescription` (string, required, nullable)
- `awards` (list of Public Award, required)
- `location` (string, required, nullable)
- `callToActionUrl` (string, required, nullable)
- `callToActionResolvedUrl` (string, required, nullable)
- `callToActionLabel` (string, required, nullable)
- `externalUrl` (string, required, nullable)
- `certifications` (list of Public AssignedCertificationSerializerReader, required)
- `resources` (list of Public Resource, required)
- `specialOffers` (list of Public SpecialOffer, required, nullable)
- `clients` (list of Public Client, required, nullable)
- `testimonials` (list of Public Testimonial, required, nullable)
- `useCases` (list of UseCases, required, nullable)
- `accreditations` (list of Public Accreditations, required, nullable)
- `keywords` (list of Public Keyword, required)
- `verifications` (list of Public VerificationAssignment, required, nullable)
- `badges` (list of Public BadgeAssignment, required, nullable)
- `media` (list of Public BaseProfileMedia, required, nullable)
- `caseStudies` (list of CaseStudyPublicSerializerReader, required, nullable)
- `locations` (list of PartnerLocationDetailSerializerReader, required, nullable)
- `tracking` (PartnerTracking, required)
- `supportEmail` (string, required, nullable)
- `developerName` (string, required, nullable)
- `availability` (boolean, required, nullable)
- `contactRequestsEnabled` (boolean, required)
- `metaTitle` (string, required, nullable)
- `metaDescription` (string, required, nullable)
- `modified` (datetime, required, nullable)
- `marketplaceSettings` (map from string to any, required, nullable)
- `embedTitle` (string, optional, nullable)
- `embedSrc` (string, optional, nullable)
- `embedHeight` (integer, optional, nullable)
- `profileFields` (map from string to any, optional) — The directory's own public profile fields that this partner filled in, by field key. Each value's shape follows the field's type.
- `mainAreaFilters` (list of Public MainAreaFilter, optional)

## Errors

### 404 Not Found Error

No public or searchable partner with this slug

- `any`

## Types

### Public Callouts

- `id` (string, required)
- `name` (string, required)
- `textColor` (string, required, nullable)
- `backgroundColor` (string, required, nullable)
- `order` (integer, required)
- `url` (string, optional)

### Public BaseFilter

- `id` (string, required)
- `name` (string, required)

### Public FilterOption

- `id` (string, required)
- `name` (string, required)
- `order` (integer, required)
- `slug` (string, required)
- `image` (string, required, nullable)
- `filter` (string, required)
- `parentOptionId` (string, required, nullable)
- `parentOptionSlug` (string, required, nullable)
- `hasResults` (boolean, optional, nullable)

### GenericTierSlugDetailReader

- `title` (string, required)
- `image` (string, optional, nullable)

### Public Award

- `id` (string, required)
- `title` (string, required)
- `file` (string, required, nullable)
- `order` (integer, required)

### Public AssignedCertificationSerializerReader

- `id` (string, required)
- `title` (string, required)
- `order` (integer, required)
- `quantity` (integer, required)

### Public Resource

- `id` (string, required)
- `title` (string, required)
- `order` (integer, required)
- `url` (string, optional, nullable)
- `file` (string, optional, nullable)

### Public SpecialOffer

- `id` (string, required)
- `title` (string, required)
- `order` (integer, required)
- `url` (string, optional, nullable)
- `file` (string, optional, nullable)

### Public Client

- `id` (string, required)
- `title` (string, required)
- `order` (integer, required)
- `url` (string, optional, nullable)
- `file` (string, optional, nullable)

### Public Testimonial

- `id` (string, required)
- `authorName` (string, required)
- `position` (string, required)
- `companyName` (string, required)
- `testimonialText` (string, required)
- `order` (integer, required)

### UseCases

- `id` (string, required)
- `title` (string, required)
- `description` (string, required)

### Public Accreditations

- `id` (string, required)
- `title` (string, required)
- `numberOfCertifiedIndividuals` (integer, required, nullable)
- `order` (integer, required)
- `file` (string, optional, nullable)

### Public Keyword

- `id` (string, required)
- `name` (string, required)

### Public VerificationAssignment

- `id` (string, required)
- `title` (string, required)

### Public BadgeAssignment

- `id` (string, required)
- `title` (string, required)
- `image` (string, required)
- `imageUrl` (string, optional, nullable)

### Public BaseProfileMedia

- `id` (string, required)
- `title` (string, required, nullable)
- `description` (string, required, nullable)
- `url` (string, required, nullable)
- `file` (string, required, nullable)
- `order` (integer, required, nullable)
- `pdfFileThumbnailUrl` (string, required, nullable)
- `type` (string, required, nullable)

### CaseStudyPublicSerializerReader

- `id` (string, required)
- `title` (string, required, nullable)
- `description` (string, required, nullable)
- `url` (string, required, nullable)
- `file` (string, required, nullable)
- `pdfFileThumbnailUrl` (string, required, nullable)
- `order` (integer, required, nullable)
- `type` (string, required, nullable)

### PartnerLocationDetailSerializerReader

- `id` (string, required)
- `title` (string, required)
- `order` (integer, required)
- `country` (integer, required)
- `countryName` (string, required)
- `region` (integer, required, nullable)
- `regionName` (string, required, nullable)
- `city` (integer, required, nullable)
- `cityName` (string, required, nullable)

### PartnerTracking

- `umamiWebsiteId` (string, required, nullable)

### Public MainAreaFilter

Filter flagged to render in the main area of the entry profile as a supported / unsupported matrix instead of the sidebar list.

- `id` (string, required)
- `name` (string, required)
- `slug` (string, required)
- `order` (integer, required)
- `filterOptions` (list of Public MainAreaFilterOption, required)

### Public MainAreaFilterOption

Option of a filter rendered in the main area of the entry profile. Every option of the filter is listed, `assigned` tells whether the entry has it.

- `id` (string, required)
- `name` (string, required)
- `order` (integer, required)
- `slug` (string, required)
- `image` (string, required, nullable)
- `assigned` (boolean, required)

## Examples

**Response**

```json
{
  "href": "/api/directory/public/v1alpha/directories/e2b2a65f-0972-4fb4-96bb-498a63411bb6/entries/partners/slugs/the-best-partner/",
  "id": "237ff0f4-e9d5-4be6-a21a-5c913836d523",
  "title": "The Best Partner",
  "headline": "The partner that you were waiting for.",
  "type": "partner",
  "slug": "the-best-partner",
  "customSlug": null,
  "featured": true,
  "owner": null,
  "icon": "https://image.domain.com/icon.png",
  "image": "https://image.domain.com/partner.png",
  "iconDark": "https://image.domain.com/icon-dark.png",
  "imageDark": "https://image.domain.com/partner-dark.png",
  "callouts": [
    {
      "id": "68c18fe3-9450-44dd-bc57-b332c53ce069",
      "name": "One Callout",
      "textColor": "#635BFF",
      "backgroundColor": "#E8E6FF",
      "order": 0
    }
  ],
  "website": "https://the-best-partner.com/",
  "filters": [
    {
      "id": "bb79b73a-923f-4bc6-8e5e-8fc326e5d789",
      "name": "Filter One"
    }
  ],
  "assignedFilterOptions": [
    {
      "id": "de1f695f-f4f1-4699-8989-246377d14aed",
      "name": "option-2",
      "order": 1,
      "slug": "option-2",
      "image": "https://image.domain.com/award.png",
      "filter": "bb79b73a-923f-4bc6-8e5e-8fc326e5d789",
      "parentOptionId": null,
      "parentOptionSlug": null,
      "hasResults": null
    },
    {
      "id": "91292760-12fa-4858-a6bd-f1dded3905e2",
      "name": "other option",
      "order": 2,
      "slug": "other-option",
      "image": "https://image.domain.com/other-option.png",
      "filter": "bb79b73a-923f-4bc6-8e5e-8fc326e5d789",
      "parentOptionId": null,
      "parentOptionSlug": null,
      "hasResults": null
    }
  ],
  "status": "public",
  "recommendedOrder": null,
  "rating": 1.9,
  "numberOfReviews": 14,
  "numberOfReviewsByRating": null,
  "tier": {
    "title": "Gold",
    "image": null
  },
  "description": "The partner that you were waiting for, no, seriously.",
  "integrationDescription": null,
  "awards": [
    {
      "id": "68c18fe3-9450-44dd-bc57-b332c53ce069",
      "title": "Partner of the year",
      "file": "https://image.domain.com/award.png",
      "order": 0
    }
  ],
  "location": "Ciudad de la Costa, Canelones, Uruguay",
  "callToActionUrl": "https://just.do.it.com/",
  "callToActionResolvedUrl": "https://just.do.it.com/",
  "callToActionLabel": "Call to action Label",
  "externalUrl": "https://external.partner.url.com/",
  "certifications": [
    {
      "id": "b2a0414d-f05d-4f34-a2f3-990116b9cdfd",
      "title": "Certification 3 (order 0)",
      "order": 0,
      "quantity": 14
    },
    {
      "id": "8fb8379e-7049-4bb9-95d4-a3017d235789",
      "title": "Certification 1 (order 1)",
      "order": 1,
      "quantity": 14
    },
    {
      "id": "85929f1d-10e3-459a-8e2d-622ed16d5110",
      "title": "Certification 2 (order 2)",
      "order": 2,
      "quantity": 1
    }
  ],
  "resources": [
    {
      "id": "e4f88344-ec9d-438b-9e05-f2f4cc89ed88",
      "title": "Entry Resource",
      "order": 0,
      "url": "https://partner.domain.com/resource",
      "file": null
    }
  ],
  "specialOffers": [
    {
      "id": "e4f88344-ec9d-438b-9e05-f2f4cc89ed88",
      "title": "Entry Special Offer",
      "order": 0,
      "url": "https://partner.domain.com/special-offer",
      "file": null
    }
  ],
  "clients": [
    {
      "id": "e4f88344-ec9d-438b-9e05-f2f4cc89ed88",
      "title": "Client Entry",
      "order": 0,
      "url": "https://client.domain.com/client-url",
      "file": null
    }
  ],
  "testimonials": [
    {
      "id": "134427f8-d25e-466a-806e-7145523a471e",
      "authorName": "John Doe",
      "position": "Project Manager",
      "companyName": "Company Inc.",
      "testimonialText": "This is a great testimonial",
      "order": 0
    }
  ],
  "useCases": [],
  "accreditations": [],
  "keywords": [],
  "verifications": [
    {
      "id": "5a4045d7-9dbb-49ee-9132-180665dcdc3b",
      "title": "A Verification"
    },
    {
      "id": "ada6a021-e996-4d12-85dd-1d5220f67da4",
      "title": "B Verification"
    }
  ],
  "badges": [
    {
      "id": "2ba1382f-8ea8-4e49-a43f-0caeb9aa92a7",
      "title": "A Badge",
      "image": "https://image.domain.com/app.png",
      "imageUrl": "https://image.domain.com/app.png"
    },
    {
      "id": "f59f8837-67be-4db1-8e5f-852e9465bfb0",
      "title": "B Badge",
      "image": "https://image.domain.com/app.png",
      "imageUrl": "https://image.domain.com/app.png"
    }
  ],
  "media": [
    {
      "id": "6a5fc0f0-c938-4b4e-85c2-b895a90b000d",
      "title": "Media 1",
      "description": "Media 1 description",
      "url": "https://image.domain.com/partner.png",
      "file": "https://image.domain.com/partner.png",
      "order": 0,
      "pdfFileThumbnailUrl": "https://image.domain.com/partner.png",
      "type": "I"
    }
  ],
  "caseStudies": [],
  "locations": [],
  "tracking": {
    "umamiWebsiteId": "ed2faba6-7aec-459a-b997-97fcfc390709"
  },
  "supportEmail": "support@domain.com",
  "developerName": "The Best Partner Developer",
  "availability": null,
  "contactRequestsEnabled": true,
  "metaTitle": "The Best Partner: certified implementation partner",
  "metaDescription": null,
  "modified": "2021-09-01T00:00:00Z",
  "marketplaceSettings": null,
  "embedTitle": null,
  "embedSrc": null,
  "embedHeight": null,
  "profileFields": {
    "projects_delivered": 120,
    "team_size": {
      "key": "size_51_200",
      "label": "51-200 people"
    }
  },
  "mainAreaFilters": [
    {
      "id": "0e3c1b1e-7a1a-4b2c-9f3d-2a6e1c9b7d10",
      "name": "Marketplace Integration Features",
      "slug": "marketplace-integration-features",
      "order": 1,
      "filterOptions": [
        {
          "id": "3f1d2c4b-5a6e-4f70-8b91-0c2d3e4f5a6b",
          "name": "Manage Menus",
          "order": 0,
          "slug": "manage-menus",
          "image": null,
          "assigned": true
        },
        {
          "id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
          "name": "Manage Orders",
          "order": 1,
          "slug": "manage-orders",
          "image": null,
          "assigned": false
        }
      ]
    }
  ]
}
```

**SDK Code**

```python Example response
import requests

url = "https://v1.api.partnerpage.io/api/directory/public/v1alpha/directories/directoryId/entries/partners/slugs/slug/"

response = requests.get(url)

print(response.json())
```

```javascript Example response
const url = 'https://v1.api.partnerpage.io/api/directory/public/v1alpha/directories/directoryId/entries/partners/slugs/slug/';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```