> ## Documentation Index
> Fetch the complete documentation index at: https://syncupai-feat-human-edits.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Place Job Results

> Understand the structure of job results returned by batch endpoints

## Overview

When you retrieve jobs from the batch endpoints, each job includes inputs, outputs, reasoning, and confidence scores. This guide explains those sections and provides a clean example.

* **Batch docs**: [Batch Processing](/guides/batch-processing)
* **API reference**: See the Place Enrichment Batch endpoints in the API reference for your version.

## Sections

* **Inputs**: What you submitted for a place. These are the fields we use to locate and enrich the place (e.g., name, coordinates, address, country).
* **Outputs**: The enriched attributes we found, such as website, phone, opening\_hours, categories, ratings, and review counts.
* **Reasoning**: Brief, structured notes explaining how each attribute was determined (when available).
* **Confidence scores**: A per-attribute confidence level reflecting the reliability of the result.

## Example Response

The example below removes internal processing metadata and focuses on what your application will typically use.

```json theme={null}
{
  "jobs": [
    {
      "place_id": "place_123",
      "status": "completed",
      "job_metadata": {
        "last_enriched": "2025-03-10T15:35:00Z",
        "country_code": "US",
        "attribute_status": {
          "website": "RUN",
          "phoneNumbers": "RUN",
          "openingHours": "RUN",
          "categories": "RUN"
        }
      },
      "inputs": {
        "id": "place_123",
        "name": "Joe's Pizza",
        "latitude": 40.7359,
        "longitude": -73.9911,
        "full_address": "7 Carmine St, New York, NY 10014",
        "country_code": "US"
      },
      "outputs": {
        "website": "https://www.joespizzanyc.com",
        "phone": null,
        "opening_hours": { "Monday": "11:00-23:00", "Tuesday": "11:00-23:00" },
        "categories": ["restaurant", "pizza"],
        "average_rating": 4.5,
        "review_count": 1200
      },
      "reasoning": {
        "websites": "Structured reasoning…",
        "phone": "No phone found on official site.",
        "opening_hours": "Structured reasoning…",
        "categories": "Structured reasoning…"
      },
      "confidence_scores": {
        "website": "HIGH",
        "phone": "LOW",
        "opening_hours": "MEDIUM",
        "categories": "HIGH"
      }
    }
  ],
  "total": 1,
  "limit": 10000,
  "offset": 0
}
```

## Schemas

### Confidence Scores

Confidence levels indicate how reliable a given attribute is:

```python theme={null}
class ConfidenceScore(str, Enum):
    VERY_HIGH = "VERY_HIGH"
    HIGH = "HIGH"
    MEDIUM = "MEDIUM"
    LOW = "LOW"
    NONE = "NONE"
```

* **VERY\_HIGH/HIGH**: Safe to use directly
* **MEDIUM**: Generally reliable; consider validation for critical use cases
* **LOW**: Use with caution; may require manual review
* **NONE**: No reliable data found

### Attribute Statuses

Each attribute can include a processing status in `job_metadata.attribute_status` to indicate how enrichment proceeded:

```ts theme={null}
export type AttributeStatus = 'RUN' | 'RUN_CONDITION_FAILED' | 'NOT_RUN' | 'ERROR'
```

* **RUN**: Enrichment was attempted (and completed); the attribute value may be present or null.
* **RUN\_CONDITION\_FAILED**: Skipped because preconditions were not met (e.g., missing inputs or failing filters).
* **NOT\_RUN**: Not attempted (e.g., disabled, out of scope, or limits).
* **ERROR**: Attempted but failed due to an error.

Attributes that commonly include a status entry include `website`, `phoneNumbers`, `openingHours`, and `categories`.

## Next Steps

* Submit a batch following the [Batch Processing](/guides/batch-processing) guide, then poll for completion and retrieve results.
* Use the `confidence_scores` and `attribute_status` to drive QA workflows or manual review where needed.

## Attribute Outputs

Types: `string` | `number` | `list of strings`

* websites
  * website: string

* email\_address
  * email: string

* phoneNumbers
  * phone: string
  * phone\_additional: list of strings

* openingHours
  * opening\_hours: list of strings
  * opening\_hours\_grouped\_by\_hours: list of strings
  * is\_open\_24h: string

* menu
  * menu\_urls: list of strings
  * menu\_url\_official: string
  * menu\_content: string
  * menu\_images: list of strings

* price\_tier
  * price\_tier: string
  * average\_price: number
  * currency: string

* cuisine
  * cuisines: list of strings

* user\_reviews
  * user\_review\_count: number
  * user\_average\_rating: number
  * user\_wilson\_score: number
  * user\_popularity: number
  * user\_review\_summary: string
  * user\_summary: string

* approximate\_user\_reviews
  * approximate\_review\_count: number
  * approximate\_average\_rating: number

* closed\_permanently
  * open\_closed\_status: string
  * open\_closed\_status\_confidence\_score: string
  * date\_closed: string
  * date\_opened: string

* chain
  * chain\_id: string
  * chain\_name: string
  * chain\_domains: list of strings
  * alternative\_names: list of strings
  * chain\_wikipedia\_url: string
  * number\_of\_locations: number
  * logo\_url: string

* reprompt\_id
  * reprompt\_id: string

* names
  * name: string
  * multilingual\_names: list of strings
  * alt\_name: string
  * official\_name: string
  * brand\_name: string

* name\_translations
  * name\_translations: list of strings

* socialHandles
  * instagram: string
  * facebook: string
  * tiktok: string

* tiktok
  * tiktok: string
  * tiktok\_followers: number
  * tiktok\_video\_count: number
  * tiktok\_bio: string

* address
  * address: string
  * address\_localized: string

* categories
  * categories: list of strings

* naics
  * naics\_code: string
  * naics\_description: string

* merchant
  * merchant\_category\_code: string
  * mcc\_description: string
  * merchant\_category\_group: string
  * merchant\_super\_industry: string

* coordinates
  * coordinates: string
  * coordinates\_distance: number

* social\_media\_profile
  * facebook\_followers: number
  * facebook\_likes: number
  * facebook\_page\_id: string
  * facebook\_bio: string
  * instagram\_followers: number
  * instagram\_media\_count: number
  * instagram\_profile\_pic\_url: string
  * instagram\_bio: string

* instagram\_statistics
  * instagram\_monthly\_user\_counts: list of strings
  * instagram\_monthly\_like\_counts: list of strings
  * instagram\_monthly\_interaction\_counts: list of strings

* website\_traffic
  * website\_traffic\_monthly\_visits: number
  * website\_traffic\_source\_social\_percentage: number
  * website\_traffic\_source\_paid\_referrals\_percentage: number
  * website\_traffic\_source\_mail\_percentage: number
  * website\_traffic\_source\_referrals\_percentage: number
  * website\_traffic\_source\_search\_percentage: number
  * website\_traffic\_source\_direct\_percentage: number
  * website\_traffic\_top\_keywords: list of strings

* parking\_spaces
  * parking\_spaces\_total: number
  * parking\_spaces\_street: number
  * parking\_spaces\_shared: number
  * parking\_spaces\_dedicated: number
  * parking\_spaces\_image\_url: string

* traffic\_control
  * traffic\_control: string

* one\_line\_summary
  * one\_line\_summary: string

* geometry
  * buildings\_geojson: string
  * parking\_geojson: string
  * parcels\_geojson: string
  * visualization\_image\_url: string
  * analysis\_metadata: string

* located\_within
  * located\_within\_name: string
  * located\_within\_type: string
  * located\_within\_floor\_or\_level: string

* storefrontImages
  * storefront\_images: list of strings

* place\_existence
  * entity\_type: string
  * digital\_footprint: string
  * place\_definition: string
  * place\_reality: string