web
You’re offline. This is a read only version of the page.
close
Skip to main content

Notifications

Announcements

No record found.

News and Announcements icon
Community site session details

Community site session details

Session Id :
Dynamics 365 Community / Forums / Small and medium business | Business Central, N... / REST API to fetch purc...
Small and medium business | Business Central, N...
Suggested Answer

REST API to fetch purchase documents

(0) ShareShare
ReportReport
Posted on by OliverM 5

Hi experts,

I would like to fetch purchase documents posted in business central (cloud) using http/REST API in order to connect another app.
The API-Reference https://docs.microsoft.com/de-de/dynamics-nav/api-reference/v1.0/ seems to be the current one.

However, using this API it seems to be not possible to query purchase order documents.

That's why I was looking around and have found another REST-OData Endpoint named /ODataV4/ ... and it is acutally working calling /ODataV4/Company('CRONUS DE')/purchaseDocuments.

However, I could not find any documentation about that /ODataV4-API.

So, I am confused. Please let me know:

  • Why there are two different OData API's, /ODataV4 and /api.
  • Who should use which API?
  • What is the right API to collect purchase order data?
  • Is there a ODataV4-API documentation?

Thanks in advance, Oli

I have the same question (0)
  • raelhefn Profile Picture
    raelhefn on at

    Hi OliverM,

    docs.microsoft.com/.../odata-web-services

    Why there are two different OData API's, /ODataV4 and /api.

    V4 : alot of new features avaiable in OData V4

    docs.oasis-open.org/.../new-in-odata-v4.0-cn01.html

    Odata : for integration capability with others

    www.progress.com/.../odata-faqs-why-should-rest-api-developers-use-odata

    Who should use which API?

    Specialist in this domain, Dev. , Const.

    What is the right API to collect purchase order data?

    Please refer to this post

    community.dynamics.com/.../841320

    https://community.dynamics.com/business/f/dynamics-365-business-central-forum/293610/need-to-get-the-purchase-order-header-and-details-in-a-single-api-call

    Is there a ODataV4-API documentation?

    docs.microsoft.com/.../walkthrough-creating-and-interacting-odata-v4-bound-action

    docs.microsoft.com/.../devenv-creating-and-interacting-with-odatav4-bound-action

    Thanks

  • OliverM Profile Picture
    OliverM 5 on at

    Hello Ramy,

    First of all thank you for your answers.
    I see I have asked my questions misleadingly :-) I am very familiar with the general use of OData APIs.

    I am specifically confused about the OData service /ODataV4, which can be called like this: /v2.0/PRODUCTION/ODataV4/Company('CRONUS DE')/purchaseDocuments.
    This service offers the required functionality, but there is apparently no API reference or documentation for this service. 
    So I'm unsure if I should use this API at all.

    If I am wrong, please link the API-Reference of /ODataV4, in which the available Entities are listed and explained.

    In contrast, the service /api is well documented here, but it does not provide any purchase order data.

    Thanks Oliver

  • Suggested answer
    raelhefn Profile Picture
    raelhefn on at

    Hi OliverM,

    There are many of generic doc's.

    docs.microsoft.com/.../

    docs.microsoft.com/.../devenv-creating-and-interacting-with-odatav4-bound-action

    docs.microsoft.com/.../

    docs.microsoft.com/.../endpoints-apis-for-dynamics

    For purchase order data the below posts can assist you:

    community.dynamics.com/.../841320

    community.dynamics.com/.../need-to-get-the-purchase-order-header-and-details-in-a-single-api-call

  • jjku Profile Picture
    jjku on at

    We are just learning about BC. And have had good luck with this:

    api.businesscentral.dynamics.com/.../PurchaseOrder

    Of course replace 2383c526-aef3-47e9-8487-47712e689168 with your tenant GUID

  • Suggested answer
    Saurav.Dhyani Profile Picture
    Saurav.Dhyani 14,380 Super User 2025 Season 2 on at

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Responsible AI policies

As AI tools become more common, we’re introducing a Responsible AI Use…

Neeraj Kumar – Community Spotlight

We are honored to recognize Neeraj Kumar as our Community Spotlight honoree for…

Congratulations to the November Top 10 Community Leaders!

These are the community rock stars!

Leaderboard > Small and medium business | Business Central, NAV, RMS

#1
OussamaSabbouh Profile Picture

OussamaSabbouh 3,151

#2
Jainam M. Kothari Profile Picture

Jainam M. Kothari 1,443 Super User 2025 Season 2

#3
YUN ZHU Profile Picture

YUN ZHU 1,092 Super User 2025 Season 2

Last 30 days Overall leaderboard

Featured topics

Product updates

Dynamics 365 release plans