# Develop custom APIs with pages and queries
> NOTE
> 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.
> We also welcome contributions to our documentation. Learn more about contributing in Contribute to the help<../help/contributor-guide#contributing>.
RESTful 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.
Business 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.
> TIP
> 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>.
> NOTE
> Extending API pages and queries isn't currently possible in Business Central.
## Create APIs
When you create an API, consider how you intend to use it:
 If you need to read and write data, use a page of the type API.
 If you need a read-only joined or aggregated dataset from one or more tables, use a query of the type API.
The two approaches come with different characteristics as described in this table:
Method to expose data as an API|Characteristics
API 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
API query|Supports read-only operations <br> Can't be extended <br> Can expose data from multiple tables
> TIP
> 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.
## Get started with APIs
The following table includes links to help you get started with designing and working with APIs.
To|See
Create APIs using an API page|API pages<devenv-api-pagetype>
Create APIs using an API query|API queries<devenv-api-querytype>
Go through an example of how to develop a custom API page|Walkthrough: developing a custom API<devenv-develop-custom-api>
Learn how to create performant APIs|API performance<../webservices/web-service-performance>
Learn 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>
Troubleshoot API call failures|Troubleshooting API calls<../webservices/dynamics-error-codes>
Monitor API calls with telemetry|API telemetry<../webservices/web-service-telemetry>
Explore built-in APIs|REST API web services<../webservices/api-overview>
Compare 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>
## Related information
API page type<devenv-api-pagetype>
API queries<devenv-api-querytype>
Walkthrough: Developing a custom API<devenv-develop-custom-api>
Troubleshooting API calls<../webservices/dynamics-error-codes>
API performance<../webservices/web-service-performance>
API client performance<../webservices/odata-client-performance>
Tips for working with APIs<devenv-connect-apps-tips>
Using filters with API calls<devenv-connect-apps-filtering>
API telemetry<../webservices/web-service-telemetry>
Built-in API overview<../webservices/api-overview>
Web services overview (APIs, SOAP/OData)<../webservices/web-services>

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. https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-api/
