Skip to main content

Notifications

Announcements

Check out the New Agent Creator Community
Announcing new navigation menus and the Engage with the Community forum!
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

  • Suggested answer
    Saurav.Dhyani Profile Picture
    Saurav.Dhyani 14,316 Super User 2025 Season 1 on at
    REST API to fetch purchase documents
  • jjku Profile Picture
    jjku on at
    RE: REST API to fetch purchase documents

    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
    raelhefn Profile Picture
    raelhefn on at
    RE: REST API to fetch purchase documents

    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

  • OliverM Profile Picture
    OliverM 5 on at
    RE: REST API to fetch purchase documents

    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

  • raelhefn Profile Picture
    raelhefn on at
    RE: REST API to fetch purchase documents

    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

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

News and Announcements

Check out the New Agent Creator Community
Announcing new navigation menus and the Engage with the Community forum!

Quick Links

Jainam Kothari – Community Spotlight

We are honored to recognize Jainam Kothari as our June 2025 Community…

Congratulations to the May Top 10 Community Leaders!

These are the community rock stars!

Announcing the Engage with the Community forum!

This forum is your space to connect, share, and grow!

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

#1
Sohail Ahmed Profile Picture

Sohail Ahmed 1,452

#2
YUN ZHU Profile Picture

YUN ZHU 1,313 Super User 2025 Season 1

#3
Gerardo Rentería García Profile Picture

Gerardo Rentería Ga... 1,083 Most Valuable Professional

Last month Overall leaderboard

Featured topics

Product updates

Dynamics 365 release plans