> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.lettbestilt.no/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.lettbestilt.no/_mcp/server.

# Get a menu import

GET https://www.lettbestilt.no/api/v1/partner/restaurants/{slug}/menu-imports/{importId}

**Partner key + restaurant key.** The draft with the proposal and status, including changes saved from the preview in the restaurant dashboard. A draft past `expiresAt` has status `EXPIRED`. Imports from before the restaurant came to the partner give `404`.

Reference: https://docs.lettbestilt.no/api-reference/partner/get-menu-import

## Authentication

- `Authorization` header (bearer token, required) — The partner key, sent as `Authorization: Bearer lbp_test_…`. Created in LettBestilt Partner under **Partner key**. It belongs to the partner, not to a restaurant, and only works against `/api/v1/partner`. Server to server only: a request with an `Origin` header is rejected with `403 FORBIDDEN`. A test key sees and creates only sandboxes; live partner keys are not available yet. A revoked key, a restaurant key (`lbs_…`) here, or a suspended or archived partner returns `401 UNAUTHORIZED`; an expired key returns `401 KEY_EXPIRED`.
- `X-LettBestilt-Restaurant-Key` header (required) — The restaurant's own key (`lbs_test_…` or `lbs_live_…`), sent in `X-LettBestilt-Restaurant-Key` together with the partner key for calls about one restaurant. The key must have full access (scope `*`, otherwise `403 INSUFFICIENT_SCOPE`), belong to a restaurant the partner owns, and be in the same environment as the partner key (otherwise `401 UNAUTHORIZED`). A slug that does not exist, belongs to another partner or does not match the key always gives the same `404 RESTAURANT_NOT_FOUND`. Older keys without an environment in the prefix (`lbs_<random>`) are not accepted here; rotate them in LettBestilt Partner.

## Request

### Path parameters

- `slug` (string, required) — The restaurant's slug.
- `importId` (string, required) — The import's `id`.

## Response

### 200

The menu import.

- `data` (PartnerMenuImport, required)

## Errors

### 401 Unauthorized Error

`UNAUTHORIZED`: a key is missing, invalid or revoked, the two keys are in different environments, or the partner is suspended or archived. `KEY_EXPIRED`: one of the keys is past its expiry date.

- `error` (ErrorBody, required)

### 403 Forbidden Error

`FORBIDDEN`: the request has an `Origin` header. `PARTNER_AGREEMENT_REQUIRED`: live key, but the partner agreements are not signed. `PARTNER_NOT_APPROVED`: LettBestilt has not approved the partner yet. `INSUFFICIENT_SCOPE`: the restaurant key does not have full access.

- `error` (ErrorBody, required)

### 404 Not Found Error

`RESTAURANT_NOT_FOUND`, or `MENU_IMPORT_NOT_FOUND` when the import does not exist or belongs to another restaurant.

- `error` (ErrorBody, required)

### 429 Too Many Requests Error

`RATE_LIMITED`: more than 120 calls per minute for this partner key.

- `error` (ErrorBody, required)

## Types

### PartnerMenuImport

- `id` (string, required)
- `status` (enum, required)
  - Allowed values: `DRAFT`, `COMMITTED`, `DISCARDED`, `EXPIRED`
- `fileName` (string, required, nullable)
- `pageCount` (integer, required)
- `createdAt` (datetime, required)
- `expiresAt` (datetime, required) — Utkastet slettes etter 7 dager.
- `committedMenuId` (string, required, nullable) — Menyen som ble laget ved commit.
- `proposal` (MenuImportProposal, required) — Forslaget fra tolkeren, med endringene som er lagret fra forhåndsvisningen i dashbordet. Til commit trengs bare feltene i `MenuImportCommitProposal`; du kan sende dette objektet (eventuelt redigert) som det er, og resten ignoreres. Høyst 60 kategorier og 800 produkter. Med tekstlag sjekkes hver pris og hvert navn mot PDF-teksten (`PRICE_NOT_IN_TEXT`, `NAME_NOT_IN_TEXT`); uten tekstlag har forslaget advarselen `CHECK_AGAINST_MENU`.

### ErrorBody

- `code` (enum, required) — A machine-readable error code. The list comes from the platform spec, which a test keeps in step with the code. See the Errors guide for what each code means.
  - Allowed values: `MISSING_SLUG`, `MISSING_TOKEN`, `INVALID_JSON`, `INVALID_SUCCESS_URL`, `INVALID_CANCEL_URL`, `VALIDATION_FAILED`, `RESTAURANT_NOT_FOUND`, `ORDER_NOT_FOUND`, `RATE_LIMITED`, `BAD_REQUEST`, `UNAUTHORIZED`, `FORBIDDEN`, `INSUFFICIENT_SCOPE`, `KEY_EXPIRED`, `POPUP_NOT_AVAILABLE`, `PRICE_CHANGED`, `PAYMENT_INCOMPLETE`, `PAYMENT_PENDING`, `PAYMENT_PROVIDER_INVALID`, `FULFILLMENT_NOT_ALLOWED`, `IDEMPOTENCY_CONFLICT`, `DINE_IN_DISABLED`, `PARTY_TOO_LARGE`, `TOO_EARLY`, `NO_TABLE`, `INVALID_PARTY_SIZE`, `INTERNAL_ERROR`, `PARTNER_AGREEMENT_REQUIRED`, `IDEMPOTENCY_KEY_REQUIRED`, `SLUG_TAKEN`, `SANDBOX_LIMIT`, `RETENTION`, `RESTAURANT_ARCHIVED`, `KEY_NOT_FOUND`, `KEY_IN_USE`, `WEBHOOK_NOT_FOUND`, `WEBHOOK_LIMIT`, `CHANGED`, `PDF_TOO_LARGE`, `PDF_INVALID`, `PDF_PASSWORD`, `PDF_TOO_MANY_PAGES`, `PDF_NO_TEXT`, `PDF_PARSE_TIMEOUT`, `MENU_IMPORT_EMPTY`, `FILE_UNSUPPORTED`, `IMAGE_HEIC`, `IMAGE_INVALID`, `IMAGE_DIMENSIONS`, `MENU_IMPORT_UNAVAILABLE`, `MENU_IMPORT_AI_LIMIT`, `MENU_IMPORT_TOO_BIG`, `MENU_IMPORT_NOT_FOUND`, `MENU_IMPORT_CLOSED`, `PARTNER_NOT_APPROVED`, `PARTNER_DATA_LOCKED`, `DOMAIN_NOT_FOUND`, `DOMAIN_TAKEN`, `DOMAIN_LIMIT`, `DOMAIN_MANAGED`, `DOMAIN_NOT_VERIFIED`, `OWNER_EXISTS`, `OWNER_EMAIL_NOT_ALLOWED`, `OWNER_INVITE_NOT_FOUND`, `SANDBOX_NOT_SUPPORTED`, `INVITE_SEND_FAILED`, `GO_LIVE_NOT_REQUIRED`, `GO_LIVE_NOT_READY`, `GO_LIVE_CHECKS_FAILED`, `GO_LIVE_ALREADY_REQUESTED`, `GO_LIVE_ALREADY_APPROVED`, `GO_LIVE_NOTHING_TO_WITHDRAW`
- `message` (string, required) — A human-readable explanation. Often in Norwegian, and for business rules usually suitable to show the customer.
- `requestId` (string, required) — The same value as the `X-Request-Id` response header. Search for it in the API log in LettBestilt Partner, and include it when you contact LettBestilt.
- `details` (any, optional) — Extra data for some codes, for example `issues` for `VALIDATION_FAILED`, the totals for `PRICE_CHANGED` or `requiredScope` for `INSUFFICIENT_SCOPE`.

### MenuImportProposal

Forslaget fra tolkeren, med endringene som er lagret fra forhåndsvisningen i dashbordet. Til commit trengs bare feltene i `MenuImportCommitProposal`; du kan sende dette objektet (eventuelt redigert) som det er, og resten ignoreres. Høyst 60 kategorier og 800 produkter. Med tekstlag sjekkes hver pris og hvert navn mot PDF-teksten (`PRICE_NOT_IN_TEXT`, `NAME_NOT_IN_TEXT`); uten tekstlag har forslaget advarselen `CHECK_AGAINST_MENU`.

- `version` (any, required)
- `categories` (list of MenuImportCategory, required)
- `warnings` (list of MenuImportProposalWarningsItems, required)
- `ignoredLines` (list of MenuImportProposalIgnoredLinesItems, required) — Tekst tolkeren hoppet over (overskrifter, adresse, telefon …).
- `stats` (MenuImportProposalStats, required)
- `source` (MenuImportSource, optional) — Mangler på utkast fra før 18.10.2026.

### MenuImportCategory

- `key` (string, required)
- `name` (string, required)
- `confidence` (double, required)
- `uncertain` (boolean, required)
- `reasons` (list of enum, required)
  - Allowed values: `NO_PRICE`, `PRICE_HIGH`, `NAME_SUSPICIOUS`, `VARIANT_LABEL_MISSING`, `TWO_LINE`, `CATEGORY_GUESSED`, `CATEGORY_WEAK`, `GLUTEN_GRAIN_GUESSED`, `ALLERGEN_UNKNOWN`, `ALCOHOL_SUSPECT`, `PRICE_NOT_IN_TEXT`, `NAME_NOT_IN_TEXT`, `MODEL_UNSURE`, `TEXT_CLEANED`
- `products` (list of MenuImportProduct, required)

### MenuImportProposalWarningsItems

- `code` (enum, required)
  - Allowed values: `ALLERGENS_DEFAULT_NUMBERING`, `ALLERGEN_LEGEND_FOUND`, `TRUNCATED`, `ALCOHOL_SUSPECT`, `CHECK_AGAINST_MENU`, `FALLBACK_PARSER`, `PRICES_NOT_IN_TEXT`
- `message` (string, required)

### MenuImportProposalIgnoredLinesItems

- `page` (integer, required)
- `text` (string, required)

### MenuImportProposalStats

- `pages` (integer, required)
- `lines` (integer, required)
- `products` (integer, required)
- `uncertain` (integer, required)

### MenuImportSource

Hvor forslaget kom fra. `engine: "model"` = språkmodellen, `"parser"` = den deterministiske tolkeren (reserve). `checkedAgainstText: false` (bilde eller skannet PDF) betyr at prisene IKKE er kontrollert mot tekst: sjekk hver pris mot menyen før commit. `fallback` sier hvorfor reservetolkeren ble brukt.

- `engine` (enum, required)
  - Allowed values: `model`, `parser`
- `input` (enum, required) — `pdf_text` (PDF med tekstlag), `pdf_scan` (skannet PDF) eller `image`.
  - Allowed values: `pdf_text`, `pdf_scan`, `image`
- `checkedAgainstText` (boolean, required)
- `fallback` (enum, required)
  - Allowed values: `NOT_CONFIGURED`, `LIMIT`, `UNAVAILABLE`, `INVALID`, `EMPTY`

### MenuImportProduct

- `key` (string, required) — Nøkkel i forslaget (ikke en database-id).
- `number` (integer, required, nullable) — Rettens nummer («12. Pepperoni» → 12). Ved import blir navnet «12. Pepperoni».
- `name` (string, required)
- `description` (string, required, nullable)
- `price` (integer, required, nullable) — Øre. null når produktet har varianter (prisen ligger da på variantene; den første blir standard).
- `variants` (list of MenuImportVariant, required)
- `allergens` (list of enum, required) — Allergenkoder fra katalogen (samme som `product.allergens` i /api/v1/menu). Må bekreftes av restauranten.
  - Allowed values: `WHEAT`, `RYE`, `BARLEY`, `OATS`, `SPELT`, `KAMUT`, `CRUSTACEANS`, `EGGS`, `FISH`, `PEANUTS`, `SOYBEANS`, `MILK`, `NUTS`, `CELERY`, `MUSTARD`, `SESAME`, `SULPHITES`, `LUPIN`, `MOLLUSCS`
- `confidence` (double, required)
- `uncertain` (boolean, required) — true når confidence \< 0,8.
- `reasons` (list of enum, required) — Hvorfor linja er usikker. ALCOHOL_SUSPECT er bare et flagg.
  - Allowed values: `NO_PRICE`, `PRICE_HIGH`, `NAME_SUSPICIOUS`, `VARIANT_LABEL_MISSING`, `TWO_LINE`, `CATEGORY_GUESSED`, `CATEGORY_WEAK`, `GLUTEN_GRAIN_GUESSED`, `ALLERGEN_UNKNOWN`, `ALCOHOL_SUSPECT`, `PRICE_NOT_IN_TEXT`, `NAME_NOT_IN_TEXT`, `MODEL_UNSURE`, `TEXT_CLEANED`
- `page` (integer, required)

### MenuImportVariant

- `name` (string, required) — Størrelsen slik den sto i PDF-en, f.eks. «Liten» eller «30 cm».
- `price` (integer, required, nullable) — Øre. Tolkeren gir alltid en pris; null er en størrelse som er lagt til i forhåndsvisningen i dashbordet uten pris ennå. Commit avviser null.

## Examples

**Response**

```json
{
  "data": {
    "id": "string",
    "status": "DRAFT",
    "fileName": "string",
    "pageCount": 1,
    "createdAt": "2024-01-15T09:30:00Z",
    "expiresAt": "2024-01-15T09:30:00Z",
    "committedMenuId": "string",
    "proposal": {
      "version": null,
      "categories": [
        {
          "key": "string",
          "name": "string",
          "confidence": 0.5,
          "uncertain": true,
          "reasons": [
            "NO_PRICE"
          ],
          "products": [
            {
              "key": "string",
              "number": 1,
              "name": "string",
              "description": "string",
              "price": 1,
              "variants": [
                {
                  "name": "string",
                  "price": 1
                }
              ],
              "allergens": [
                "WHEAT"
              ],
              "confidence": 0.5,
              "uncertain": true,
              "reasons": [
                "NO_PRICE"
              ],
              "page": 1
            }
          ]
        }
      ],
      "warnings": [
        {
          "code": "ALLERGENS_DEFAULT_NUMBERING",
          "message": "string"
        }
      ],
      "ignoredLines": [
        {
          "page": 1,
          "text": "string"
        }
      ],
      "stats": {
        "pages": 1,
        "lines": 1,
        "products": 1,
        "uncertain": 1
      },
      "source": {
        "engine": "model",
        "input": "pdf_text",
        "checkedAgainstText": true,
        "fallback": "NOT_CONFIGURED"
      }
    }
  }
}
```

**SDK Code**

```python
import requests

url = "https://www.lettbestilt.no/api/v1/partner/restaurants/slug/menu-imports/importId"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://www.lettbestilt.no/api/v1/partner/restaurants/slug/menu-imports/importId';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.lettbestilt.no/api/v1/partner/restaurants/slug/menu-imports/importId"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://www.lettbestilt.no/api/v1/partner/restaurants/slug/menu-imports/importId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://www.lettbestilt.no/api/v1/partner/restaurants/slug/menu-imports/importId")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://www.lettbestilt.no/api/v1/partner/restaurants/slug/menu-imports/importId', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://www.lettbestilt.no/api/v1/partner/restaurants/slug/menu-imports/importId");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://www.lettbestilt.no/api/v1/partner/restaurants/slug/menu-imports/importId")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```