The Detail endpoint enables you to get varying levels of detail about specific locations

The Detail API provides rich, comprehensive information about specific venues. After using the Search API to find venues that match your criteria, use these endpoints to get detailed information including photos, menus, events, and more.

How it works

Endpoint structure

All detail endpoints follow this pattern:

GET /v1/establishments/{level}/{venueId}

Where:

{level} is the detail level (basic, advanced, menus)
{venueId} is the venue ID from your search results

Detail levels

Basic Details

Essential venue information with 5 images. Perfect for search result previews and basic venue cards.

Advanced Details

Complete venue profile including all images, detailed descriptions, amenities, and comprehensive data.

Menus

Active menus, pricing, and food/drink offerings. Essential for dining apps and venue discovery.

Provided data

Feature	Search Results	Basic Details	Advanced Details	Menus
Cost per 1k requests	£6	£8	£12	£6
Name	✓	✓	✓
Display name	✓	✓	✓
Formatted address	✓	✓	✓
Location Coordinates	✓	✓	✓
Website	✓	✓	✓
Email	✓	✓	✓
Phone	✓	✓	✓
Description	✓	✓	✓
Primary Genre	✓	✓	✓
Additional Genres	✓	✓	✓
Word on the street	✓	✓	✓
Opening times	Matching request	✓	✓
isChain	✓	✓	✓
Establishment options	Matching request	✓	✓
Catering options	Matching request	✓	✓
Main Image	✓	✓	✓
Logo	✓	✓	✓
All Images		✓	✓
Average price per head		✓	✓
Special opening times (e.g. Christmas)		✓	✓
Kitchen open times		✓	✓
Booking link		✓	✓
Ratings		✓	✓
Accessibility		✓	✓
Payment		✓	✓
Parking		✓	✓
Extra information (e.g. Registered number)			✓
Social media links			✓
Active menus			✓	✓
Active events			✓

When to use each endpoint

Basic Details

Use for:

Search result previews
Venue list items
Quick venue information
Performance-critical applications

Advanced Details

Use for:

Venue profile pages
Detailed venue information
Rich user experiences
Complete venue data

Menus

Use for:

Food and drink apps
Menu browsing
Pricing information
Dietary information

Real-world examples

async function buildVenueList(searchResults: SearchResult[]) {
  const venuePromises = searchResults.map(async (result) => {
    const detailResponse = await fetch(
      `/v1/establishments/basic/${result.id}`,
      {
        headers: { "Api-Key": `${process.env.API_KEY}` },
      },
    );
    return await detailResponse.json();
  });
 
  return Promise.all(venuePromises);
}

Response structure comparison

Basic Details

Basic details response type

type BasicDetails = {
  id: string;
  name: string;
  displayName: string;
  formattedAddress: string;
  location: {
    type: string;
    coordinates: [number, number];
  };
  websiteUri: string;
  contactEmail: string;
  contactNumber: string;
  description: string;
  primaryGenre: string;
  additionalGenres: string[];
  wordOnTheStreet: string;
  isChain: boolean;
  regularOpeningHours: {
    days: string[];
    timeSlots: {
      open: string;
      close: string;
      isClosed: boolean;
      closeNextDay: boolean;
    }[];
  }[];
  mainImageUrl: string;
  logo: string;
  establishmentFlags: string[];
  catersFlags: string[];
  photos: {
    url: string;
    caption: string | null;
  }[];
  avgPPH: string;
  specialOpeningHours: {
    date: string;
    timeSlots: {
      open: string;
      close: string;
      isClosed: boolean;
      closeNextDay: boolean;
    }[];
  }[];
  kitchenOpenTimes: {
    days: string[];
    timeSlots: {
      open: string;
      close: string;
      isClosed: boolean;
      closeNextDay: boolean;
    }[];
  }[];
  bookingUrl: {
    url: string;
    provider: string;
  };
  ratings: {
    rating: string;
    userRatingCount: number;
  };
  accessibility: {
    entrance: boolean;
    parking: boolean;
    bathroom: boolean;
    seating: boolean;
  };
  payment: {
    credit: boolean;
    debit: boolean;
    cash: boolean;
    nfc: boolean;
    online: boolean;
    amex: boolean;
    amexFee: boolean;
    exclAmex: boolean;
  };
  parking: {
    street: boolean;
    garage: boolean;
    lot: boolean;
    valet: boolean;
  };
};

Advanced Details

Advanced details response type

type AdvancedDetails = {
  id: string;
  name: string;
  displayName: string;
  formattedAddress: string;
  location: {
    type: string;
    coordinates: [number, number];
  };
  websiteUri: string;
  contactEmail: string;
  contactNumber: string;
  description: string;
  primaryGenre: string;
  additionalGenres: string[];
  wordOnTheStreet: string;
  isChain: boolean;
  regularOpeningHours: {
    days: string[];
    timeSlots: {
      open: string;
      close: string;
      isClosed: boolean;
      closeNextDay: boolean;
    }[];
  }[];
  mainImageUrl: string;
  logo: string;
  establishmentFlags: string[];
  catersFlags: string[];
  photos: {
    url: string;
    caption: string | null;
  }[];
  avgPPH: string;
  specialOpeningHours: {
    date: string;
    timeSlots: {
      open: string;
      close: string;
      isClosed: boolean;
      closeNextDay: boolean;
    }[];
  }[];
  kitchenOpenTimes: {
    days: string[];
    timeSlots: {
      open: string;
      close: string;
      isClosed: boolean;
      closeNextDay: boolean;
    }[];
  }[];
  bookingUrl: {
    url: string;
    provider: string;
  };
  ratings: {
    rating: string;
    userRatingCount: number;
  };
  accessibility: {
    entrance: boolean;
    parking: boolean;
    bathroom: boolean;
    seating: boolean;
  };
  payment: {
    credit: boolean;
    debit: boolean;
    cash: boolean;
    nfc: boolean;
    online: boolean;
    amex: boolean;
    amexFee: boolean;
    exclAmex: boolean;
  };
  parking: {
    street: boolean;
    garage: boolean;
    lot: boolean;
    valet: boolean;
  };
  extraInformation: {
    key?: string; 
    value?: string; 
  }[]; 
  socialMediaLinks: {
    url?: string; 
  }[]; 
  activeMenus: Menu[]; 
  activeEvents: {}[]; 
};

Menus

Menus response type

type Menu = {
  name: string;
  description?: string;
  price?: number;
  sections: MenuSection[];
};
 
type MenuSection = {
  name: string;
  description?: string;
  price?: number;
  subSections?: MenuSection[];
  items: MenuItem[];
};
 
type MenuItem = {
  name: string;
  description?: string;
  ingredients?: string[];
  price?: number;
  calories?: number;
  dietaryFlags?: string[];
  choices?: MenuItemChoice[];
};
 
type MenuItemChoice = {
  name: string;
  description?: string;
  choiceType: "SINGLE" | "GROUP";
  price?: number;
  choices?: MenuItemChoice[];
  required?: boolean;
  minSelections?: number;
  maxSelections?: number;
  options: MenuItemChoiceOption[];
};
 
type MenuItemChoiceOption = {
  name: string;
  description?: string;
  price?: number;
  calories?: number;
  dietaryFlags?: string[];
  defaultSelected?: boolean;
  maxQuantity?: number;
  minQuantity?: number;
};

Performance considerations

Advanced details can have a relatively large response size, if this is a concern you should use the basic details endpoint when you don't need the additional data.

Detail Endpoints Overview

How it works

Endpoint structure

Detail levels

Basic Details

Advanced Details

Menus

Provided data

When to use each endpoint

Basic Details

Advanced Details

Menus

Real-world examples

Response structure comparison

Basic Details

Advanced Details

Menus

Performance considerations

Next steps

Basic Details

Advanced Details

On this page