/enabavki/contracts

POST /api/enabavki/contracts

Price: 1 credit

North Macedonia public procurement contract award notification from e-nabavki.gov.mk by id: buyer, supplier, contract number, estimated and assigned values with VAT, bids received with the bidders, lots, award criteria, beneficial owners of the suppliers, changes, and the contract files.

How to use it

Takes the `id` of an enabavki/contracts/search row, current or archived; `tender_id` resolves through enabavki/tenders. `owned_vendors` holds each supplier's beneficial owners as disclosed; `beneficial_owner_stage` says whether they were disclosed.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• id string required — Contract id from enabavki/contracts/search (examples: "5b74b08d-57fe-40b1-bdbe-354ac029d67d"; pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$)

Response

• @type string (default: "EnabavkiContract")
• id string required
• definition_id string nullable
• tender_id string nullable
• process_number string nullable
• contract_number string nullable
• subject string nullable
• description string nullable
• buyer object nullable
  • @type string (default: "EnabavkiBuyer")
  • name string nullable
  • address string nullable
  • city string nullable
  • postal_code string nullable
  • category string nullable
  • main_activity string nullable
  • email string nullable
  • phone string nullable
  • website string nullable
  • contact_person string nullable
  • contact_phone string nullable
  • contact_email string nullable
  • contact_fax string nullable
  • contact_page string nullable
  • authorized_person string nullable
  • authorized_person_email string nullable
  • authorized_person_phone string nullable
• procedure_type string nullable
• procedure_type_id string nullable
• contract_type string nullable
• procurement_item string nullable
• offer_type string nullable
• is_price_only boolean nullable
• sector string nullable
• delivery_location string nullable
• cpvs array (default: [])
  • @type string (default: "EnabavkiCpv")
  • code string nullable
  • description string nullable
  • role string nullable
• has_referent_nomenclature boolean nullable
• published_at integer nullable
• created_at integer nullable
• awarded_at integer nullable
• delivered_at integer nullable
• cancelled_at integer nullable
• vendor_id string nullable
• vendor_name string nullable
• vendor_registration_number string nullable
• vendor_address string nullable
• vendor_city string nullable
• vendor_country string nullable
• estimated_value number nullable
• estimated_value_vat number nullable
• changed_estimated_value number nullable
• has_changed_estimated_value boolean nullable
• assigned_value number nullable
• assigned_value_vat number nullable
• assigned_value_without_vat number nullable
• previous_assigned_value number nullable
• value_difference number nullable
• vat_rate number nullable
• offer_count integer nullable
• highest_offer_value number nullable
• lowest_offer_value number nullable
• is_group_bid boolean nullable
• has_subcontractors boolean nullable
• group_members array (default: [])
  • @type string (default: "EnabavkiGroupMember")
  • id string nullable
  • name string nullable
  • surname string nullable
  • registration_number string nullable
  • tax_number string nullable
  • email string nullable
  • phone string nullable
  • mobile string nullable
  • is_domestic boolean nullable
• subcontractors array (default: [])
  • @type string (default: "EnabavkiGroupMember")
  • id string nullable
  • name string nullable
  • surname string nullable
  • registration_number string nullable
  • tax_number string nullable
  • email string nullable
  • phone string nullable
  • mobile string nullable
  • is_domestic boolean nullable
• bidders array (default: [])
  • @type string (default: "EnabavkiBidder")
  • id string nullable
  • name string nullable
  • registration_number string nullable
  • tax_number string nullable
  • address string nullable
  • settlement string nullable
  • municipality string nullable
  • phone string nullable
  • fax string nullable
  • email string nullable
  • website string nullable
  • is_domestic boolean nullable
  • is_foreign_without_owners boolean nullable
  • vendor_type string nullable
  • vendor_status integer nullable
  • status integer nullable
  • categories array (default: [])
    • @type string (default: "EnabavkiVendorCategory")
    • name string nullable
    • category_id string nullable
    • amount number nullable
    • amount_foreign number nullable
    • currency string nullable
    • is_subscribed boolean nullable
    • is_entity_category boolean nullable
  • beneficial_owners array (default: [])
    • @type string (default: "EnabavkiBeneficialOwner")
    • id string nullable
    • full_name string nullable
    • vendor_id string nullable
• beneficial_owner_stage string nullable (one of: "before_disclosure_rules", "no_information", "consent_not_given", "has_beneficial_owner", "consent_given_no_information")
• beneficial_owners array (default: [])
  • @type string (default: "EnabavkiBeneficialOwner")
  • id string nullable
  • full_name string nullable
  • vendor_id string nullable
• owned_vendors array (default: [])
  • @type string (default: "EnabavkiOwnedVendor")
  • vendor_id string nullable
  • name string nullable
  • registration_number string nullable
  • beneficial_owner_stage string nullable (one of: "before_disclosure_rules", "no_information", "consent_not_given", "has_beneficial_owner", "consent_given_no_information")
  • beneficial_owners array (default: [])
    • @type string (default: "EnabavkiBeneficialOwner")
    • id string nullable
    • full_name string nullable
    • vendor_id string nullable
• is_cancellation boolean nullable
• is_due_to_crisis boolean nullable
• crisis_type string nullable
• has_transparency_notification boolean nullable
• is_divided boolean nullable
• lots array (default: [])
  • @type string (default: "EnabavkiContractLot")
  • id string nullable
  • lot_id string nullable
  • number integer nullable
  • subject string nullable
  • offer_count integer nullable
  • highest_offer_value number nullable
  • lowest_offer_value number nullable
  • item_count integer nullable
  • is_selected boolean nullable
  • has_items boolean nullable
  • has_auction boolean nullable
  • had_electronic_auction boolean nullable
  • had_final_price_bid boolean nullable
  • is_reevaluated boolean nullable
• lot_submission object nullable
  • @type string (default: "EnabavkiLotSubmission")
  • segments_submission integer nullable
  • segments_submission_label string nullable
  • max_lots_per_bid integer nullable
  • has_max_lots_awarded_per_operator boolean nullable
  • max_lots_awarded_per_operator integer nullable
• criteria array (default: [])
  • @type string (default: "EnabavkiCriterion")
  • name string nullable
  • points number nullable
  • points_distribution string nullable
  • is_price boolean nullable
• is_framework_agreement boolean nullable
• framework_agreement object nullable
  • @type string (default: "EnabavkiFrameworkAgreement")
  • agreement_type string nullable
  • agreement_sub_type string nullable
  • agreement_type_label string nullable
  • is_between_several_operators boolean nullable
  • is_between_several_buyers boolean nullable
  • months integer nullable
  • vendors array (default: [])
    • @type string (default: "EnabavkiOwnedVendor")
    • vendor_id string nullable
    • name string nullable
    • registration_number string nullable
    • beneficial_owner_stage string nullable (one of: "before_disclosure_rules", "no_information", "consent_not_given", "has_beneficial_owner", "consent_given_no_information")
    • beneficial_owners array (default: [])
• dynamic_purchase object nullable
  • @type string (default: "EnabavkiDynamicPurchase")
  • is_dynamic_purchase_system boolean nullable
  • duration_years integer nullable
  • duration_months integer nullable
• duration_years integer nullable
• duration_months integer nullable
• duration_days integer nullable
• starts_at integer nullable
• ends_at integer nullable
• allows_alternative_offers boolean nullable
• uses_electronic_tools boolean nullable
• electronic_tools_information string nullable
• has_electronic_auction boolean nullable
• without_auction_reason string nullable
• had_electronic_auction boolean nullable
• had_final_price_bid boolean nullable
• agreement_count string nullable
• procedure_information string nullable
• procedure_description string nullable
• change_reason string nullable
• has_prior_notice boolean nullable
• has_notice_changes boolean nullable
• has_other_notices boolean nullable
• has_announced_change boolean nullable
• has_duration_changes boolean nullable
• has_assigned_value_changes boolean nullable
• has_assigned_value_without_vat_changes boolean nullable
• has_vat_changes boolean nullable
• has_contract_value_changes boolean nullable
• is_change_report boolean nullable
• is_terminated boolean nullable
• is_international boolean nullable
• is_consultant boolean nullable
• is_central_body_procurement boolean nullable
• is_group_procurement boolean nullable
• is_public_private_partnership boolean nullable
• is_estimated_value_changed boolean nullable
• has_procurement_bureau_agreement boolean nullable
• is_published_by_group_member boolean nullable
• evidence_number string nullable
• law_version integer nullable
• documents array (default: [])
  • @type string (default: "EnabavkiDocument")
  • name string nullable
  • url string nullable
  • category string nullable
  • document_type string nullable
  • file_id string nullable
  • contract_id string nullable
  • related_id string nullable
  • created_at integer nullable
  • is_generated boolean nullable
• awarded object nullable
  • @type string (default: "EnabavkiAwardedTotals")
  • estimated_value number nullable
  • changed_estimated_value number nullable
  • total_assigned_value number nullable
  • is_divided boolean nullable
  • contracts array (default: [])
    • @type string (default: "EnabavkiAwardedContract")
    • subject string nullable
    • vendor_name string nullable
    • buyer_name string nullable
    • procedure_type string nullable
    • procedure_type_id string nullable
    • procedure_type_label string nullable
    • notice_type string nullable
    • notice_type_label string nullable
    • lot_numbers string nullable
    • estimated_value number nullable
    • changed_estimated_value number nullable
    • assigned_value number nullable
    • realized_value number nullable
    • has_price_change boolean nullable
    • is_terminated boolean nullable
    • has_prior_notice boolean nullable
    • is_assigned_value_public boolean nullable

Errors

• 422 — The id is not a GUID Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — No contract notification with that id Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.