1. Public directory reads
PartnerPage API
  • Introduction
  • Authentication
  • Object Overview
  • Verify and handle webhook deliveries
  • Directory webhook events and payloads
  • Partner lead webhook event
  • Build your own directory site
  • Directory
    • Forms
      • Get all custom forms
      • Get all currency field options
      • Get all contact request form
      • Get default contact request form
      • Create a cotact request custom form
      • Delete a contact request custom form
    • Callouts
      • Get all callouts
      • Get a callout
      • Create a new callout
      • Update a directory callout
      • Delete a directory callout
    • Badges
      • Get all badges
      • Get a badge
      • Create a badge
      • Update a badge
      • Delete a badge
    • Certifications
      • Get all certifications
      • Get a certification
      • Create a certification
      • Update a certification
      • Delete a certification
    • Filters
      • Filter Options
        • Get all filter options
        • Get a filter option
        • Create a filter option
        • Update a filter option
        • Deletes a filter option
      • Get all filters
      • Get a filter
      • Create a filter
      • Update a filter
      • Deletes a filter
      • Get all internal filters
      • Get all filters for external directory
    • Filter Maps
      • Get all filter option mappings
      • Get a filter option mapping
      • Create a new filter option mapping
      • Update a filter option mapping
      • Delete a filter option mapping
      • Get all filter option mappings for external directory
    • Matchmaking
      • Get all matchmaking requests
    • Tiers
      • Get all tiers
      • Get a tier
      • Create a tier
      • Update a tier
      • Delete a tier
      • Get all entries assigned to an specific tier
      • Assign or Unassign entries to an specific tier
    • Verifications
      • Get all verifications
      • Get a verification
      • Create a verification
      • Update a verification
      • Delete a verification
    • Settings
      • Retrieve the settings for a directory
      • Update the settings for a directory
    • List directories
      GET
    • Get a directory
      GET
    • Create a directory
      POST
    • Update a directory
      PATCH
  • Entry
    • App Entry
      • Callouts
        • Get all callouts
        • Get an entry callout
        • Create a new callout
        • Update a callout
        • Delete a callout
      • Get an app entry
      • Create new app entry
      • Update app entry
      • Delete a app entry
      • Update the recommended order of an app entry
    • Partner Entry
      • Badges
        • Get all badges
        • Get a badge
        • Create a badge
        • Update a badge
        • Delete a badge
      • Callouts
        • Get all callouts
        • Get a callout
        • Create a callout
        • Update a callout
        • Delete a callout
      • Certifications (General)
        • Get all certifications
        • Get a certification
        • Create a certification
        • Update a certification
        • Delete a certification
      • Certifications (Industry)
        • Get all industry certifications
        • Get an industry certification
        • Create an industry certification
        • Update an industry certification
        • Delete an industry certification
      • Certifications (Segment)
        • Get all segment certifications
        • Get a segment certification
        • Create a segment certification
        • Update a segment certification
        • Delete a segment certification
      • Client
        • Get all Clients
        • Get a client
        • Create a client
        • Update a client
        • Delete a client
      • Keywords
        • Get all keywords
        • Get a keyword
        • Create a keyword
        • Update keyword
        • Delete a keyword
      • Locations
        • Get all location
        • Get a location
        • Create a location
        • Update a location
        • Delete a location
      • Media
        • Get all media
        • Get a media
        • Create a media
        • Update a media
        • Delete a media
      • Resources
        • Internal
          • Get all Internal resources
          • Get an internal resource
          • Create an internal resource
          • Update an internal resource
          • Delete an internal resource
        • Get all resouces
        • Get a resource
        • Create a resource
        • Update a resource
        • Delete a resource
      • Special Offers
        • Get all special offer
        • Get a special offer
        • Create a special offer
        • Update a special offer
        • Delete a special offer
      • Testimonials
        • Internal
          • Get all internal testimonial
          • Get an internal testimonial
          • Create an internal testimonial
          • Update an internal testimonial
          • Delete an internal testimonial
        • Get all testimonials
        • Get a testimonial
        • Create a testimonial
        • Update a testimonial
        • Delete a testimonial
      • Use Cases
        • Internal
          • Get all internal use cases
          • Get an internal use cases
          • Create an internal use case
          • Update an internal use case
          • Delete an internal use case
        • Get all use cases
        • Get a use case details
        • Create a use case
        • Update a use case
        • Delete a use case
      • Verifications
        • Get all verifications
        • Get a verification
        • Create a verification
        • Update a verification
        • Delete a verification
      • Contact Information
        • Return entry contact information
      • Invite
        • Get organization matches for partner invite
        • Get partner entry owner organization invite
        • Get partner entry owner user invites
        • Invite organization to own partner entry
        • Invite users to partner entry ownership
      • Entry Edits Approval Flow
        • Partner Entry Submit Review
        • Partner Entry Approve Review
        • Partner Entry Reject Changes
        • Partner Entry Discard Review
      • Get a partner's internal directory profile by slug
      • Get a partner entry
      • Create a partner entry
      • Update a partner entry
      • Delete a partner entry
      • Bulk upsert partner entries
      • Update the recommended order of a partner entry
    • List directory entries
      GET
  • Contact Request
    • Attachment
      • List contact request attachments
      • Create contact request attachment
      • Delete contact request attachment
    • Get all contact requests
    • Get a contact request
    • Create a new partner contact request
  • Matchmaking
    • Get all matchmaking requests
    • Get a matchmaking request
    • Create a new directory matchmaking request
    • Get all partners assigned to matchmaking requests
    • Assign an owner to a matchmaking request
    • Set partners to a matchmaking request
  • Review
    • directory-review-list
    • directory-review-detail
    • directory-review-create
    • Update a review
    • Delete a review
    • reviewsDirectoryExportRetrieve
  • Public directory reads
    • List a directory's filters and their options
      GET
    • Get a partner's profile by slug
      GET
    • List and search a directory's partners
      GET
  1. Public directory reads

List and search a directory's partners

GET
https://v1.api.partnerpage.io/api/search/v1alpha/directories/{directoryId}/entries/
Lists the partners and apps a directory shows to its visitors, the same reads the directory's own pages use. No API key is needed.
Which listings come back: without search or filters, only public listings. Once either is set, searchable listings are included too. hidden and inactive listings are never returned.
Add include=filter_options to also get each listing's status and assignedFilterOptions, so a site can show and filter partner cards without one details request per partner. With page_size=120, a directory of up to 120 listings comes back in one request; larger directories page with next.
Results can trail an edit by a few seconds. The partner details endpoint always reads the latest approved profile.
To page through ordering=random, follow the next links or pass a seed. Without one, every request gets a fresh shuffle. An unknown directory returns an empty list.

Request

Path Params

Query Params

Responses

🟢200
application/json
One page of listings
Bodyapplication/json

🟠400
🟠404
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://v1.api.partnerpage.io/api/search/v1alpha/directories//entries/?availability=&entry_type=&featured=&filters=(cross-industry%2Ceducation)(global)&include=&ordering=&page=&page_size=&search=&seed='
Response Response Example
{
    "count": 2,
    "next": null,
    "previous": null,
    "facets": {},
    "results": [
        {
            "id": "eda239ce-813f-43d8-b78b-b38ae62536b8",
            "title": "A very nice partner",
            "icon": "https://admin.partnerpage.io/media/directories/icons/eda239ce-813f-43d8-b78b-b38ae62536b8/e9c13a85-250b-4d3d-beb7-6a7d205aae92.png",
            "image": "https://admin.partnerpage.io/media/directories/images/eda239ce-813f-43d8-b78b-b38ae62536b8/c9e0f039-7b26-485e-b453-efc79d6b3bb9.png",
            "iconDark": "https://admin.partnerpage.io/media/directories/icons-dark/eda239ce-813f-43d8-b78b-b38ae62536b8/4c1d3f46-8d1b-4a6c-9e40-2e5e1d6a7b3c.png",
            "imageDark": "https://admin.partnerpage.io/media/directories/images-dark/eda239ce-813f-43d8-b78b-b38ae62536b8/0a4f0d1e-7a3b-4b6d-8d0e-9c2f4e5a6b7c.png",
            "headline": "A very nice partner to have.",
            "description": "We help teams roll out AI.",
            "entryType": "partner",
            "featured": false,
            "availability": true,
            "slug": "a-very-nice-partner",
            "website": "https://a-very-nice-partner.com",
            "callouts": [
                {
                    "id": "52c28cb1-491d-4db8-89ba-411600e1f718",
                    "name": "Accounting",
                    "textColor": null,
                    "backgroundColor": null,
                    "order": 0
                }
            ],
            "verifications": null,
            "rating": null,
            "numberOfReviews": null,
            "tier": {
                "title": "Gold",
                "image": "https://admin.partnerpage.io/media/directories/tiers/gold.png"
            },
            "highlightedTitle": "",
            "highlightedDescription": "",
            "status": "public",
            "assignedFilterOptions": [
                {
                    "id": "2c711188-b227-416b-9883-fa18798b4130",
                    "name": "Cross-industry",
                    "slug": "cross-industry",
                    "image": null,
                    "order": 0,
                    "filter": "13484f55-bf4f-4aab-81bf-69e6d0b46c15"
                }
            ]
        },
        {
            "id": "25a46489-9a7e-46c6-ba88-6958c3bc4fd9",
            "title": "Acme App",
            "icon": null,
            "image": "https://admin.partnerpage.io/media/directories/images/fc91ca3b-2256-48bf-a913-573f7be764cf/402bd2fd-27b5-4a62-90ac-b021eb329de6.png",
            "headline": "Some app headline",
            "iconDark": null,
            "imageDark": null,
            "description": "A professional application for all your needs",
            "entryType": "app",
            "featured": false,
            "slug": "acme-app",
            "website": "https://some.website.com/page/",
            "callouts": [],
            "tier": {},
            "highlightedTitle": "",
            "highlightedDescription": "",
            "status": "public",
            "assignedFilterOptions": []
        }
    ]
}
Modified at 2026-10-23 04:54:33
Previous
Get a partner's profile by slug
Built with