{"title":"Business Central Admin Center API - Environment database export","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/administration-center-api_environment_database_export/","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/administration/administration-center-api_environment_database_export, 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/administration/administration-center-api_environment_database_export","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 export an environment database using the Business Central Admin Center API. Discover permissions, metrics, and error handling for seamless exports.","date":"2026-07-28","meta":{"topic":"reference"},"outline":[{"level":1,"title":"Business Central Admin Center API - Environment database export","slug":"business-central-admin-center-api---environment-database-export","at":0,"chars":4934},{"level":3,"title":"Required in-product permissions for exporting an environment database","slug":"required-in-product-permissions-for-exporting-an-environment-database","at":307,"chars":238},{"level":2,"title":"Get export metrics","slug":"get-export-metrics","at":545,"chars":953},{"level":3,"title":"Route parameters","slug":"route-parameters","at":772,"chars":261},{"level":3,"title":"Response","slug":"response","at":1033,"chars":334},{"level":3,"title":"Expected error codes","slug":"expected-error-codes","at":1367,"chars":131},{"level":2,"title":"Start environment database export","slug":"start-environment-database-export","at":1498,"chars":1453},{"level":3,"title":"Route parameters","slug":"route-parameters-1","at":1759,"chars":261},{"level":3,"title":"Body","slug":"body","at":2020,"chars":546},{"level":3,"title":"Expected error codes","slug":"expected-error-codes-1","at":2566,"chars":385},{"level":2,"title":"Get export history","slug":"get-export-history","at":2951,"chars":1767},{"level":3,"title":"Route parameters","slug":"route-parameters-2","at":3411,"chars":107},{"level":3,"title":"Query parameters","slug":"query-parameters","at":3518,"chars":185},{"level":3,"title":"Response","slug":"response-1","at":3703,"chars":1015},{"level":2,"title":"Related information","slug":"related-information","at":4718,"chars":216}],"text":"# Business Central Admin Center API - Environment database export\nUse this API to export an environment's Azure database to an Azure Storage account that you provide. The number of exports allowed per month is limited. To view the current limit, use the metrics endpoint described in the following section.\n### Required in-product permissions for exporting an environment database\nTo use the exports endpoint, you must have the D365 BACKUP/RESTORE permission set assigned to your Business Central user account or authorized Microsoft Entra app.\n## Get export metrics\nGets information about the number of exports allowed per month and the amount remaining.\n```http\nGET /admin/{apiVersion}/exports/applications/{applicationFamily}/environments/{environmentName}/metrics\n```\n### Route parameters\napiVersion - version of the Admin Center API. Currently, the latest version is v2.29.\napplicationFamily - the family of the environment's application (for example, \"BusinessCentral\").\nenvironmentName - the name of the targeted environment.\n### Response\nReturns the metrics around the current month's database exports.\n```json\n{\n  \"exportsPerMonth\": int, // The total number of allowed exports of the targeted environment every month.\n  \"exportsRemainingThisMonth\": int, // The number of exports remaining for the targeted environment that can be performed this month.\n}\n```\n### Expected error codes\nenvironmentNotFound - targeted environment can't be found.\n target: {applicationFamily}/{environmentName}\n## Start environment database export\nStarts the export of an environment's database to a provided Azure storage account.\n```http\nContent-Type: application/json\nPOST /admin/{apiVersion}/exports/applications/{applicationFamily}/environments/{environmentName}\n```\n### Route parameters\napiVersion - version of the Admin Center API. Currently, the latest version is v2.29.\napplicationFamily - the family of the environment's application (for example, \"BusinessCentral\").\nenvironmentName - the name of the targeted environment.\n### Body\n```json\n{\n  \"storageAccountSasUri\": string, // An Azure SAS uri pointing at the Azure storage account where the database will be exported to. The uri must have (Read | Write | Create | Delete) permissions\n  \"container\": string, // The name of the container that will be created by the process to store the exported database.\n  \"blob\": string, // The name of the blob within the container that the database will be exported to. Databases are exported in the .bacpac format so a filename ending with the '.bacpac' suffix is typical.\n}\n```\n### Expected error codes\nenvironmentNotFound - targeted environment can't be found.\n target: {applicationFamily}/{environmentName}\nrequestBodyRequired - request body must be provided.\nexportFailed - export failed, typically because the requesting tenant doesn't have a paid subscription, the calling user doesn't have permissions to export, or the quota of allowed exports is used up.\n## Get export history\n> WARNING\n> The API endpoint to get export history is supported up until version 2.29 of the API, and is deprecated from version 2.30. Use the API endpoints on administration-center-api_environments#get-environment-operation instead.\nGets information about the exports that happen within a provided time frame, for which environment, and by which user.\n```http\nPOST /admin/{apiVersion}/exports/history?start={startTime}&end={endTime}\n```\n### Route parameters\napiVersion - version of the Admin Center API. Currently, the latest version is v2.29.\n### Query parameters\nstartTime - datetime // The start of the export history entry time window to query.\nendTime - datetime // The end of the export history entry time window to query.\n### Response\nReturns a detailed list of the database exports that occurred within the provided timeframe of the start and end query parameters.\n```json\n{\n  \"applicationType\": string, // Family of the environment (for example, \"BusinessCentral\")\n  \"applicationVersion\": string, // The version of the environment's application at the time of the export.\n  \"blob\": string, // The name of the blob that the environment's database was exported to.\n  \"container\": string, // The name of the Azure storage account container that the environment's database was exported within.\n  \"country\": string, // The country code of the environment.\n  \"environmentName\": string, // The name of the environment that was exported.\n  \"storageAccount\": string, // The name of the Azure storage account that the environent's database was exported to.\n  \"time\": dateTime, // The time that the environment's database was exported.\n  \"user\": string // The user who initiated the export process.\n}\n```\n> NOTE\n> All datetime values are in UTC.\n## Related information\nThe Business Central Administration Center API<administration-center-api>\ntenant-admin-center-manage-apps\nMicrosoft Dynamics 365 Business Central Server Administration Tool<administration-tool>"}