PartnerPage API
  1. Directory
PartnerPage API
  • Introduction
  • Authentication
  • Object Overview
  • Directory
    • Branding
      • Retrieve a directory's branding
      • Update a directory's branding
    • Forms
      • List all custom forms
      • Retrieve the default contact request form
      • Retrieve the currently active contact request form for the specified directory
      • Get all currency field options
      • Create and configure a new custom contact request form for the specified directory
      • Reset the current custom contact request form for the directory to the global default version
    • Callouts
      • Return the list of callouts details information belonging to a directory
      • Return the details of a callout
      • Create a new callout
      • Update a directory callout
      • Update a directory callout
    • Badges
      • Create a directory badge
      • Return the details of a badge
      • Update a directory badge
      • Delete a directory badge
      • Return the list of badge details information belonging to a directory
    • Certifications
      • Return the list of certifications belonging to a directory
      • Create a directory certification
      • Return a certificacion details
      • Update a directory certification
      • Delete a directory certification
    • Filters
      • Retrieve a list of filters within a directory
      • Create a filter within a directory
      • Retrieve a list of filters within a directory
      • Retrieve a list of filters for an external directory
      • Retrieve details of a single filter within a directory
      • Update a filter
      • Deletes a directory filter
      • Retrieve a list of filter options within a filter
      • Create a filter option within a custom filter
      • Deletes a directory filter option
      • Update a custom filter option
      • Retrieve details of a single filter option within a filter in a directory
    • Filter Maps
      • Delete a filter option mapping
      • Update a filter option mapping
      • Retrieve details of a single filter option mapping
      • Retrieve a list of filter option mappings within a directory
      • Create a new filter option mapping
      • Retrieve a list of filter option mappings within a directory
    • Matchmaking
      • Retrieve a list of matchmaking requests for a specific directory
    • Tiers
      • Return the list of tiers belonging to a directory
      • Create a directory tier
      • Return the details of a tier
      • Update a directory tier
      • Delete a directory tier
      • Return the list of entries assigned to an specific tier
      • Assign or Unassign entries to an specific tier
    • Verifications
      • Return the list of verification details information belonging to a directory
      • Create a directory verification
      • Return the details of a verification
      • Update a directory verification
      • Delete a directory verification
    • Return the list of directories
      GET
    • Return the list of directory details information belonging to the logged-in user organization
      GET
    • Return the detail information of a directory
      GET
    • Update generic directory details
      PATCH
    • Update the settings for a specific directory
      PATCH
    • Retrieve the settings for a specific directory
      GET
    • Return the detailed information of a directory you own
      GET
    • Retrieve detailed information about an external directory in which the user's organization has an entry
      GET
  • Entry
    • App Entry
      • Callouts
        • Return the list of app entry callouts
        • Create a new app entry callout
        • Return the details of an app entry callout
        • Update an app entry callout
        • Delete an app entry callout
      • Create new app entry
      • Returns details of an App entry from a directory
      • Update app entry
      • Delete a app entry
      • Update the recommended order of an app entry
    • Partner Entry
      • Badges
        • Return the list of partner entry badges
        • Create a new partner entry badge
        • Return the details of a partner entry badge
        • Update a partner entry badge
        • Delete a partner entry badge
      • Callouts
        • Return the list of partner entry callouts
        • Create a new partner entry callout
        • Return the details of a partner entry callout
        • Update a partner entry callout
        • Delete a partner entry callout
      • Certifications (General)
        • Return the partner entry certifications
        • Create a new partner entry certification
        • Return the details of a partner entry certification
        • Update a partner entry certification
        • Delete a partner entry certification
      • Certifications (Industry)
        • Return the partner entry industry certifications
        • Create a new partner entry industry certification
        • Return the details of a partner entry industry certification
        • Update a partner entry industry certification
        • Delete a partner entry industry certification
      • Certifications (Segment)
        • Return the partner entry segment certifications
        • Create a new partner entry segment certification
        • Return the details of a partner entry segment certification
        • Update a partner entry segment certification
        • Delete a partner entry segment certification
      • Entry Edits Approval Flow
        • Reject partner entry changes
        • Partner Entry Submit Review
        • Partner Entry Discard Review
        • Partner Entry Approve Review
      • Keywords
        • Return Keyword details
        • Create a new keyword
        • Return Keyword details
        • Update keyword details
        • Delete a keyword
      • Locations
        • Return Location details
        • Create a new location
        • Return Location details
        • Update location details
        • Delete a location
      • Media
        • Retrieve a profile media within an entry in a directory
        • Retrieve a list of profile media within an entry in a directory
        • Create new profile media
        • Update profile media
        • Delete profile media
      • Resources
        • Return Internal Resource details
        • Create a new internal resource
        • Return Internal resource details
        • Update internal resource details
        • Delete an internal resource
        • Return Resource details
        • Create a new resource
        • Return Resource details
        • Update resource details
        • Delete a resource
      • Special Offers
        • Return Special Offer details
        • Create a new special offer
        • Return Special Offer details
        • Update special offer details
        • Delete a special offer
      • Testimonials
        • Return a list with Internal Testimonial details
        • Return Internal Testimonial details
        • Create a new internal testimonial
        • Update internal testimonial details
        • Delete an internal testimonial
        • Return Testimonial details
        • Create a new testimonial
        • Return Testimonial details
        • Update testimonial details
        • Delete a testimonial
      • Use Cases
        • Return a list with internal use cases details
        • Create a new internal use case
        • Return internal use cases details
        • Update internal use case details
        • Delete an internal use case
        • Return a list with use cases details
        • Create a new use case
        • Return use cases details
        • Update use case details
        • Delete a use case
      • Verifications
        • Return the list of verifications assigned to partner entry
        • Create a new partner entry verification
        • Return the details of a partner entry verification
        • Update a partner entry verification
        • Delete a partner entry verification
      • Create new partner entry
      • Update partner entry details
      • Delete partner entry
      • Returns the details of a Partner entry from a directory
      • Returns the internal details of a Partner entry from a directory
      • Update the recommended order of a partner entry
    • Authenticated endpoint that return a paginated list of entries for an specific directory
      GET
  • Organization
    • Returns the paginated list of all Partner Entry Owner Organization invites
      GET
    • Returns a paginated list of all the entries of an organization from all the directories that its listed
      GET
    • Retrieve a list of contact requests for an entry owner organization
      GET
    • Get api directory private v1alpha organizations external analytics
      GET
    • Return the directory details of an Organization
      GET
  • Client
    • Return Client details
    • Create a new client
    • Return Client details
    • Update special client details
    • Delete a client
  • Others
    • Get listed with an authenticated user with an existing organization
    • Return partners assigned to matchmaking requests
    • Replace api directory private v1alpha directories matchmaking-requests partners
    • Return the contact information of a specific directory entry
    • Get api directory private v1alpha entries partners invite matches
    • Get api directory private v1alpha entries partners invite organization
    • Create api directory private v1alpha entries partners invite organization
    • Get api directory private v1alpha entries partners invite users
    • Create api directory private v1alpha entries partners invite users
    • Retrieve details of a contact requests for an entry owner organization
    • Retrieve details of a contact requests for an entry owner organization
    • Entry owner accepts a specific contact request
    • Entry owner declines a specific contact request
    • Return the details of an App Entry owned by an Organization
    • Update an App Entry owned by an Organization
    • Returns the paginated list of all Partner Entry Owner Organization invites
    • Returns a partner entry owner organization invite details
    • Accepts an invite for an organization to own a partner entry
    • Rejects an invite for an organization to own a partner entry
    • Return the details of a partner entry owned by an Organization
    • Update a partner entry owned by an Organization
  • Contact Request
    • Retrieve details of a contact requests for a directory owner organization
    • Retrieve a list of contact requests for a directory owner organization
  • Matchmaking
    • Return a list of possible matchmaking request owners
    • Allows an authenticated user to assign an owner (by ID) to a matchmaking request
    • Return details of a matchmaking request for a directory owner
  1. Directory

Return the list of directory details information belonging to the logged-in user organization

GET
https://v1.api.partnerpage.io/api/directory/private/v1alpha/directories/
Return the list of directory details information belonging to the logged-in user organization
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://v1.api.partnerpage.io/api/directory/private/v1alpha/directories/' \
--header 'Authorization;'
Response Response Example
[
    {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "href": "/api/directory/private/v1alpha/directories/3fa85f64-5717-4562-b3fc-2c963f66afa6/",
        "name": "Acme Directory",
        "organization": {
            "name": "Acme Inc."
        },
        "settings": {
            "customUrl": "https://acme.com/directory/",
            "featuredEntriesEnabled": false,
            "filterMappingsEnabled": false,
            "entryTypes": [
                "app",
                "partner"
            ],
            "entryTypeSettings": {
                "app": {
                    "urlSegment": "app",
                    "onCardClick": "details"
                },
                "partner": {
                    "urlSegment": "partner"
                }
            }
        },
        "branding": {
            "logo": "https://cdn.partnerpage.io/media/logos/3fa85f64-5717-4562-b3fc-2c963f66afa6/logo.png",
            "favicon": "https://cdn.partnerpage.io/media/favicons/3fa85f64-5717-4562-b3fc-2c963f66afa6/logo.png",
            "interactiveColor": "#FFFFFF",
            "actionPrimaryColor": "#AAAAAA"
        },
        "customCode": {
            "footer": "<b>My HTML footer</b>",
            "cssFile": "https://cdn.partnerpage.io/media/css/3fa85f64-5717-4562-b3fc-2c963f66afa6/custom.css",
            "navbar": "<b>My navbar HTML code</b>"
        },
        "tracking": {
            "umamiWebsiteId": "b2064f90-5fbd-427a-a7d3-d1e47b4a1900",
            "umamuShareId": "ChX32kmasdf"
        },
        "seo": {
            "metaTitle": "Acme Inc. Directory",
            "metaDescription": "Discover Acme Inc. partners and apps.",
            "metaImage": "https://cdn.partnerpage.io/media/logos/3fa85f64-5717-4562-b3fc-2c963f66afa6/logo.png",
            "indexDirectory": true,
            "siteName": "Acme Inc."
        }
    }
]

Request

Authorization
Add parameter in header
Authorization
Example:
Authorization: ********************

Responses

🟢200OK
application/json
Successful operation
Body
array of:
href
string 
Href
read-onlyoptional
id
string <uuid>
Id
required
name
string  | null 
Name
required
>= 1 characters<= 255 characters
organization
object (OrganizationDetail) 
required
name
string 
Name
required
>= 1 characters<= 255 characters
settings
object (GenericSettings) 
required
href
string 
Href
read-onlyoptional
genericDirectoryId
string <uuid>
Generic directory id
required
customUrl
string <uri> | null 
Custom url
required
>= 1 characters
globalCallToActionUrl
string  | null 
Global call to action url
required
>= 1 characters<= 255 characters
globalCallToActionLabel
string  | null 
Global call to action label
required
>= 1 characters<= 25 characters
contactButtonLabel
string  | null 
Contact button label
required
>= 1 characters<= 25 characters
featuredEntriesEnabled
boolean 
Featured entries enabled
required
entryTypes
array[string]
required
Allowed values:
apppartner
entryTypeSettings
object 
Entry type settings
required
pageSizeSelectionOnDirectory
boolean 
Page size selection on directory
required
filterMappingsEnabled
boolean 
Filter mappings enabled
required
badgesEnabled
boolean 
Badges enabled
required
calloutsEnabled
boolean 
Callouts enabled
required
customFormsEnabled
boolean 
Custom forms enabled
required
certificationsEnabled
boolean 
Certifications enabled
required
verificationsEnabled
boolean 
Verifications enabled
required
callToActionEnabled
boolean 
Call to action enabled
required
awardsEnabled
boolean 
Awards enabled
required
customSlugEnabled
boolean 
Custom slug enabled
required
keywordsEnabled
boolean 
Keywords enabled
required
mediaEnabled
boolean 
Media enabled
required
clientsEnabled
boolean 
Clients enabled
required
testimonialsEnabled
boolean 
Testimonials enabled
required
specialOffersEnabled
boolean 
Special offers enabled
required
contactRequestsEnabled
boolean 
Contact requests enabled
required
tiersEnabled
boolean 
Tiers enabled
required
matchmakingRequestsEnabled
boolean 
Matchmaking requests enabled
required
assignMatchmakingRequestEnabled
boolean 
Assign matchmaking request enabled
required
useCasesEnabled
boolean 
Use cases enabled
required
externalUrlEnabled
boolean 
External url enabled
required
showBottomBar
boolean 
Show bottom bar
required
recommendedSortEnabled
boolean 
Recommended sort enabled
required
internalDirectoryEnabled
boolean 
Internal directory enabled
required
defaultSorting
string 
Default sorting
required
>= 1 characters
entryApprovalFlowEnabled
boolean 
Entry approval flow enabled
required
supportEnabled
boolean 
Support enabled
required
locationEnabled
boolean 
Location enabled
required
locationsEnabled
boolean 
Locations enabled
required
contactRequestProjectStatusesEnabled
boolean 
Contact request project statuses enabled
required
organizationInvitesToOwnPartnersEnabled
boolean 
Organization invites to own partners enabled
required
lastUpdatedEnabled
boolean 
Last updated enabled
required
entryDisclaimerText
string  | null 
Entry disclaimer text
optional
entryDisclaimerTextEnabled
boolean 
Entry disclaimer text enabled
required
gdprEnabled
boolean 
Gdpr enabled
required
termsOfServiceUrl
string <uri> | null 
Terms of service url
required
privacyPolicyUrl
string <uri> | null 
Privacy policy url
required
assistanceTypeQuestionEnabled
boolean 
Assistance type question enabled
required
integrationDescriptionEnabled
boolean 
Integration description enabled
required
reviewsEnabled
boolean 
Reviews enabled
required
autoApproveReviewsEnabled
boolean 
Auto approve reviews enabled
required
showFullReviewInformationEnabled
boolean 
Show full review information enabled
required
i18nEnabled
boolean 
I18n enabled
required
i18nMode
enum<string> 
I18n mode
required
Allowed values:
prefixquery_param
i18nLanguages
object  | null 
I18n languages
required
crmObjectsEnabled
boolean 
Crm objects enabled
required
contactRequestsCustomFieldsForm
string <uuid> | null 
Contact requests custom fields form
required
branding
object (GenericBranding) 
required
href
string 
Href
read-onlyoptional
genericDirectoryId
string <uuid>
Generic directory id
required
The unique identifier of a directory in PartnerPage's app. Your directory UUIDs can be looked up using the /api/directory/internal/v1alpha/directories/ endpoint.
logo
string <uri> | null 
Logo
required
The logo to be displayed on the public directory.
>= 1 characters
internalLogo
string <uri> | null 
Internal logo
required
The logo to be displayed on the internal directory, if enabled for your account.
>= 1 characters
favicon
string <uri> | null 
Favicon
required
The small icon displayed in the browser tab, bookmarks, and address bar for the public directory.
>= 1 characters
internalFavicon
string <uri> | null 
Internal favicon
required
The small icon displayed in the browser tab, bookmarks, and address bar for the internal directory, if enabled for your account.
>= 1 characters
interactiveColor
string  | null 
Interactive color
required
The color to be used for UI elements on the directory when a user interacts with them, as a HEX string.
>= 1 characters<= 7 characters
Example:
#635BFF
actionPrimaryColor
string  | null 
Action primary color
required
The color of primary calls to action on the directory, as a HEX string.
>= 1 characters<= 7 characters
Example:
#635BFF
customCode
object (MinimalGenericCustomCodeDetails) 
required
href
string 
Href
read-onlyoptional
footer
string  | null 
Footer
required
>= 1 characters<= 250000 characters
cssFile
string <uri> | null 
Css file
required
>= 1 characters
navbar
string  | null 
Navbar
required
>= 1 characters<= 250000 characters
firstSection
string  | null 
First section
required
>= 1 characters<= 250000 characters
lastSection
string  | null 
Last section
required
>= 1 characters<= 250000 characters
tracking
object (Tracking) 
required
umamiWebsiteId
string <uuid> | null 
Umami website id
required
umamiShareId
string  | null 
Umami share id
required
>= 1 characters<= 100 characters
internalUmamiWebsiteId
string <uuid> | null 
Internal umami website id
optional
internalUmamiShareId
string  | null 
Internal umami share id
optional
>= 1 characters<= 100 characters
seo
object (GenericDirectorySEO) 
required
metaTitle
string  | null 
Meta title
optional

The page title defined in the tag, used in browser tabs and search engine results to summarize the page content.

<= 255 characters
metaDescription
string  | null 
Meta description
optional

A brief summary of the page content set in the tag, often displayed in search engine results below the page title.

>= 1 characters<= 300 characters
metaImage
string  | null 
Meta image
optional
The image used for link previews in social sharing platforms, defined by the og:image meta tag in the HTML head.
>= 1 characters
siteName
string  | null 
Site name
optional
>= 1 characters<= 100 characters
indexDirectory
boolean 
Index directory
required
onboardingInProgress
boolean 
Onboarding in progress
required
Modified at 2025-07-10 13:52:52
Previous
Return the list of directories
Next
Return the detail information of a directory
Built with