API Home

Requests

Contacts

 /v1/contact POST

Orgs

 /v1/org/{domain} GET
 /v1/org/{domain}/locations GET
 /v1/org/search GET

Locations

 /v1/org/{domain}/locations GET
 /v1/location/{domain} GET

Schemas

Org

object

Properties

Key Type Description
description string The description of the Org
domain string The to.co Stable Domain Name for the Org ending .{country_code}.to.co
emails Emails
industry Industry
informal_name string The informal or trading name for the Org. Often this name will shed any suffixes required by the legal name
links Links
locations OrgLocations
logo_url string The URL of the logo for the Org
name string The official or legal name of the Org
phones Phones
public_domain string The public to.co Legal Name Domain or Go Business Domain ending in .to.co which shows the to.co Page for the Org
registration Registration
updated string The time the Org was last updated in Coordinated Universal Time (UTC)
vat_registration VATRegistration
version_number integer (int32) Version number of the Org record

Example 

{
  "description": "Shop new season trends in homeware, furniture and fashion at John Lewis & Partners.",
  "domain": "yxpx6pdx.uk.to.co",
  "informal_name": "John Lewis",
  "locations": {
    "count": 3,
    "default": {
      "address_verified": true,
      "name": "John Lewis & Partners",
      "hours": {
        "normal": [
          {
            "day": 0,
            "open": false,
            "open_time": "00:00",
            "close_time": "00:00"
          },
          {
            "day": 1,
            "open": true,
            "open_time": "09:00",
            "close_time": "17:00"
          },
          {
            "day": 2,
            "open": true,
            "open_time": "09:00",
            "close_time": "17:00"
          },
          {
            "day": 3,
            "open": true,
            "open_time": "09:00",
            "close_time": "17:00"
          },
          {
            "day": 4,
            "open": true,
            "open_time": "09:00",
            "close_time": "17:00"
          },
          {
            "day": 5,
            "open": true,
            "open_time": "09:00",
            "close_time": "17:00"
          },
          {
            "day": 6,
            "open": false,
            "open_time": "00:00",
            "close_time": "00:00"
          }
        ],
        "special": [
          {
            "date": "2025-12-24",
            "open": true,
            "open_time": "09:00",
            "close_time": "16:00"
          },
          {
            "date": "2025-12-26",
            "open": true,
            "open_time": "09:00",
            "close_time": "16:00"
          }
        ]
      },
      "domain": "2hqh3aw8.loc.uk.to.co",
      "address": {
        "domain": "yyb7e4pd.a.uk.to.co",
        "line1": "171 Victoria Street",
        "line2": "London",
        "zip": "SW1E 5NN",
        "country_code": "GB"
      },
      "links": {
        "facebook_url": "https://www.facebook.com/johnlewisretail",
        "instagram_url": "https://instagram.com/johnlewis",
        "linkedin_url": "https://www.linkedin.com/company/johnlewisandpartners/",
        "tiktok_url": "https://www.tiktok.com/@johnlewis",
        "twitter_url": "https://twitter.com/JohnLewisRetail",
        "website_url": "https://www.johnlewis.com/",
        "youtube_url": "https://www.youtube.com/c/johnlewisandpartners"
      }
    }
  },
  "logo_url": "https://media.to.co/yxpx6pdx.uk.to.co/20220121T15065-7w0qIqaBp3SxY0Y3hqJb.jpg",
  "name": "John Lewis plc",
  "public_domain": "johnlewis.to.co",
  "registration": {
    "date": "1928-09-20",
    "country_code": "GB",
    "number": "00233462",
    "address": {
      "domain": "pmyn68c5.a.uk.to.co",
      "line1": "171 Victoria Street",
      "line2": "London",
      "zip": "SW1E 5NN",
      "country_code": "GB"
    }
  },
  "updated": "2022-01-27T15:50:28.000Z",
  "version_number": 1
}