{"title":"Develop custom APIs with pages and queries","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-api/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-api, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-api","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Learn how to develop custom Business Central APIs with API pages and API queries, and find guidance for performance and troubleshooting.","date":"2026-10-08","meta":{"topic":"overview"},"outline":[{"level":1,"title":"Develop custom APIs with pages and queries","slug":"develop-custom-apis-with-pages-and-queries","at":0,"chars":3948},{"level":2,"title":"Create APIs","slug":"create-apis","at":1321,"chars":909},{"level":2,"title":"Get started with APIs","slug":"get-started-with-apis","at":2230,"chars":1094},{"level":2,"title":"Related information","slug":"related-information","at":3324,"chars":624}],"text":"# Develop custom APIs with pages and queries\n> NOTE\n> We're working to improve the onboarding experience for AL developers. If you have feedback about this article, use the Feedback section at the bottom of the article to tell us what you'd like to see.\n> We also welcome contributions to our documentation. Learn more about contributing in Contribute to the help<../help/contributor-guide#contributing>.\nRESTful web services typically exchange data between Business Central and external systems. REST stands for Representational State Transfer. You can use any programming language that can call REST APIs. Business Central APIs provide versioned, OData v4-enabled REST endpoints for integrations.\nBusiness Central includes built-in APIs that require no code and minimal setup. You can also develop custom APIs by using the AL object types API pages and API queries. This article helps you get started with API development.\n> TIP\n> Use the API Overview page in Business Central to explore published API pages, API queries, and API codeunits that are available in your environment. Learn more about the API Overview page in Discover APIs with the API Overview page</api-overview?toc=/dynamics365/business-central/dev-itpro/toc.json>.\n> NOTE\n> Extending API pages and queries isn't currently possible in Business Central.\n## Create APIs\nWhen you create an API, consider how you intend to use it:\n If you need to read and write data, use a page of the type API.\n If you need a read-only joined or aggregated dataset from one or more tables, use a query of the type API.\nThe two approaches come with different characteristics as described in this table:\nMethod to expose data as an API|Characteristics\nAPI page|Supports read-write operations <br> Supports webhooks <br> Can't be extended <br> Uses one source table per API page; nested API page parts can expose related entities from other tables\nAPI query|Supports read-only operations <br> Can't be extended <br> Can expose data from multiple tables\n> TIP\n> For inspiration and examples, see the open-source ALAppExtensions repository<https://github.com/microsoft/ALAppExtensions/tree/main/Apps/W1/APIV2/app/src/pages>. The repository contains examples of API pages written in AL.\n## Get started with APIs\nThe following table includes links to help you get started with designing and working with APIs.\nTo|See\nCreate APIs using an API page|API pages<devenv-api-pagetype>\nCreate APIs using an API query|API queries<devenv-api-querytype>\nGo through an example of how to develop a custom API page|Walkthrough: developing a custom API<devenv-develop-custom-api>\nLearn how to create performant APIs|API performance<../webservices/web-service-performance>\nLearn how to query APIs|API client performance<../webservices/odata-client-performance> <br> Tips for working with APIs<devenv-connect-apps-tips> <br> Using filters with API calls<devenv-connect-apps-filtering>\nTroubleshoot API call failures|Troubleshooting API calls<../webservices/dynamics-error-codes>\nMonitor API calls with telemetry|API telemetry<../webservices/web-service-telemetry>\nExplore built-in APIs|REST API web services<../webservices/api-overview>\nCompare APIs with UI pages exposed as OData or SOAP web services|Compare REST APIs, OData, and SOAP web services in Business Central<../webservices/web-services>\n## Related information\nAPI page type<devenv-api-pagetype>\nAPI queries<devenv-api-querytype>\nWalkthrough: Developing a custom API<devenv-develop-custom-api>\nTroubleshooting API calls<../webservices/dynamics-error-codes>\nAPI performance<../webservices/web-service-performance>\nAPI client performance<../webservices/odata-client-performance>\nTips for working with APIs<devenv-connect-apps-tips>\nUsing filters with API calls<devenv-connect-apps-filtering>\nAPI telemetry<../webservices/web-service-telemetry>\nBuilt-in API overview<../webservices/api-overview>\nWeb services overview (APIs, SOAP/OData)<../webservices/web-services>"}