generated: '2026-08-12' method: searched source: https://platform.fatsecret.com/docs/guides/error-codes docs: https://platform.fatsecret.com/docs/guides/error-codes format: vendor-envelope rfc9457: false note: >- fatsecret does not use RFC 9457 problem+json. Every Platform API method can return a vendor error envelope carrying a numeric code and a message, in place of the expected result, and the transport status is not the error signal — the body is. Agents must parse the envelope, not the HTTP status. envelope: json: example: '{"error": {"code": NUMBER, "message": "TEXT"}}' fields: - path: error.code type: integer description: numeric fatsecret error code - path: error.message type: string description: human-readable message, often with a '

' suffix naming the offending value xml: namespace: http://platform.fatsecret.com/api/1.0/ example: 'NUMBERTEXT' classes: - range: 1-24 name: General / OAuth description: authentication, transport, throttling, and platform-level failures - range: 101-109 name: Parameter description: request parameter validation failures - range: 201-211 name: Application description: domain-rule failures against diary, weight, activity, and region state errors: - code: 1 category: General message: "An unknown error occurred: '

'" - code: 2 category: OAuth 1.0 message: "Missing required oauth parameter: '

'" - code: 3 category: OAuth 1.0 message: "Unsupported oauth parameter: '

'" - code: 4 category: OAuth 1.0 message: "Invalid signature method: '

'" - code: 5 category: OAuth 1.0 message: "Invalid consumer key: '

'" - code: 6 category: OAuth 1.0 message: "Invalid/expired timestamp: '

'" - code: 7 category: OAuth 1.0 message: "Invalid/used nonce: '

'" - code: 8 category: OAuth 1.0 message: "Invalid signature: '

'" - code: 9 category: OAuth 1.0 message: "Invalid access token: '

'" - code: 10 category: General message: "Unknown method: '

'" - code: 11 category: General message: "Application request limit reached: '

'" remediation: >- The account's edition quota is exhausted (Basic edition is 5,000 calls/day). This is the ONLY rate-limit signal the API emits — there are no RateLimit-* response headers and no Retry-After. rate_limit: true - code: 12 category: General message: "User is performing too many actions: '

'" remediation: Per-profile throttle, distinct from the application quota. Back off per user. rate_limit: true - code: 13 category: OAuth 2.0 message: "Invalid token: '

'" remediation: Re-request a client_credentials token from https://oauth.fatsecret.com/connect/token. - code: 14 category: OAuth 2.0 message: "Missing scope: '

'" remediation: >- The token was issued without the scope this method requires (e.g. barcode, nlp, image-recognition, localization). Re-request the token with the scope, and note that premier scopes require a Premier edition. - code: 20 category: General message: "System temporarily unavailable: '

'" - code: 21 category: General message: "Invalid IP address detected: '

'" - code: 22 category: General message: "Invalid request: '

'" - code: 23 category: General message: Api not found - code: 24 category: General message: A timeout has occurred - code: 101 category: Parameter message: "Missing required parameter: '

'" - code: 102 category: Parameter message: "Invalid integer value: '

'" - code: 103 category: Parameter message: "Invalid double value: '

'" - code: 104 category: Parameter message: "Invalid decimal value: '

'" - code: 105 category: Parameter message: "Invalid long value: '

'" - code: 106 category: Parameter message: "Invalid ID: '

'" - code: 107 category: Parameter message: "Value out of range: '

'" - code: 108 category: Parameter message: "Invalid Type: '

'" - code: 109 category: Parameter message: "Character limit exceeded: '

'" - code: 201 category: Application message: "Activity not found: '

'" - code: 202 category: Application message: "Shift To and Shift From must be different: '

'" - code: 203 category: Application message: "Too many minutes: '

'" - code: 204 category: Application message: "Date selected does not have any activity to default: '

'" - code: 205 category: Application message: "Date must be within 2 days from today: '

'" - code: 206 category: Application message: "Cannot update weight for an earlier date: '

'" - code: 207 category: Application message: "Date selected does not have any food entries to copy: '

'" - code: 208 category: Application message: "Invalid region: '

'" - code: 209 category: Application message: "Activity cannot be modified: '

'" - code: 210 category: Application message: "User cannot have templates set: '

'" - code: 211 category: Application message: No food item detected remediation: Returned by the image-recognition method when no food is found in the uploaded image. error_count: 38