> ## Documentation Index
> Fetch the complete documentation index at: https://docs.repromptai.com/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`

**Core Attributes**

`closed_permanently` attribute returns:

* open\_closed\_status `string`
* open\_closed\_status\_confidence\_score `string`

`address` attribute returns:

* `address` `string`
* `address_localized` `string`

`categories` attribute returns:

* `categories` `list of strings`

`coordinates` attribute returns:

* coordinates `string`
* coordinates\_distance `number`

`websites` attribute returns:

* website `string`

`email_address` attribute returns:

* email `string`

`phoneNumbers` attribute returns:

* phone `string`
* phone\_additional `list of strings`

`openingHours` attribute returns:

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

`names` attribute returns:

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

**Rich Attributes**

`menu` attribute returns:

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

`price_tier` attribute returns:

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

`user_reviews` attribute returns:

* 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` attribute returns:

* approximate\_review\_count `number`
* approximate\_average\_rating `number`

`chain` attribute returns:

* 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` attribute returns:

* reprompt\_id `string`

`naics` attribute returns:

* naics\_code `string`
* naics\_description `string`

`merchant` attribute returns:

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

`name_translations` attribute returns:

* name\_translations `list of strings`

`socialHandles` attribute returns:

* instagram `string`
* facebook `string`
* tiktok `string`

`tiktok` attribute returns:

* tiktok: string

`social_media_profile` attribute returns:

* facebook\_followers: number
* facebook\_likes `number`
* facebook\_page\_id `string`
* facebook\_bio `string`

`website_traffic` attribute returns:

* website\_traffic\_monthly\_visits `number`

`parking_spaces` attribute returns:

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

`one_line_summary` attribute returns:

* one\_line\_summary `string`

`geometry` attribute returns:

* buildings\_geojson `string`

`located_within` attribute returns:

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

`storefrontImages` attribute returns:

* storefront\_images `list of strings`

`place_existence` attribute returns:

* entity\_type `string`
* digital\_footprint `string`
* place\_definition `string`
* place\_reality `string`