Troubleshooting

View Apple Business portal and API production status on the Apple System Status page.

If you encounter any issues during or after your integration process, contact the Apple Business support team that aligns with the issue and onboarding phase. See Reporting API Related Issues.

If you encounter issues with location data in production, see Reporting Maps Display Issues.

To report issues related to the Business API:

Gather all relevant information about the issue.
Prepare a detailed description of the problem.
Submit your report to Business API Support.

Important submission guidelines:

Include complete API request and response details.
Specify the environment used (API integration, data qualification, or production).
Provide any error messages or unexpected behaviors observed.

Required information for each issue:

Information	Description
API endpoint	The specific endpoint that's experiencing issues
Request payload	Complete JSON/XML of the request you sent
Response received	Complete response including status codes and headers
Request IDs	Any request identifiers from the API response
Environment	Whether the issue occurs in integration, qualification, or production
Expected behavior	What you expected to happen
Actual behavior	What actually happened

Reporting Maps Display Issues

To report issues with locations displayed on Apple Maps:

Download the Location issue template (Excel).
Fill in one row for each issue (use separate rows if multiple issues affect a single location).
Submit the completed spreadsheet to Apple Business Data Support.

Important submission guidelines:

Please include locations from multiple organizations and brands in a single spreadsheet.
Always use this template, even when reporting a single issue.
Submissions without the correctly formatted template will be rejected.

Required information for each issue:

Column	Description
Organization ID	ID of the organization you represent for Apple Maps
Brand ID	ID of the brand linked to the location (if available)
Partner location ID	ID from your own internal record
Apple location ID	Apple-generated location ID from the shared record (if available)
Type of problem	Select from the dropdown (see examples in the template)
Current value	Current incorrect value of the problematic attribute
Expected value	Expected correct value of the problematic attribute
Comments	Any additional relevant information

After submission, our team will review the report.

Support Contacts by Issue Type

Issue topic	Onboarding phase	Support contact
API or Maps data-related issues	Any	Apple Business Support
Portal related issues with registration or Share Access (Delegation or OAuth app)	Any	Apple Business Brand Support