components:
  examples:
    SIMPLE_CRITERIA:
      value: |-
        {
          "registrationPeriod": {
            "beginDate": "2017-01-01",
            "endDate": "2021-01-01"
          },
          "area": {
            "enclosingCircle": {
              "center": {
                "lat": 52.038297852,
                "lon": 5.31447958948
              },
              "radius": 0.5
            }
          }
        }
  schemas:
    Area:
      properties:
        boundingBox:
          properties:
            lowerCorner:
              properties:
                lat:
                  type: number
                lon:
                  type: number
              type: object
            upperCorner:
              properties:
                lat:
                  type: number
                lon:
                  type: number
              type: object
          type: object
        enclosingCircle:
          properties:
            center:
              properties:
                lat:
                  type: number
                lon:
                  type: number
              type: object
            radius:
              type: number
          type: object
      type: object
    BhrgCriteriaSet:
      properties:
        analysisReportPeriod:
          properties:
            beginDate:
              type: string
            endDate:
              type: string
          type: object
        area:
          properties:
            boundingBox:
              properties:
                lowerCorner:
                  properties:
                    lat:
                      type: number
                    lon:
                      type: number
                  type: object
                upperCorner:
                  properties:
                    lat:
                      type: number
                    lon:
                      type: number
                  type: object
              type: object
            enclosingCircle:
              properties:
                center:
                  properties:
                    lat:
                      type: number
                    lon:
                      type: number
                  type: object
                radius:
                  type: number
              type: object
          type: object
        correctionPeriod:
          properties:
            beginDate:
              type: string
            endDate:
              type: string
          type: object
        deliveryAccountableParty:
          type: string
        depthInterval:
          properties:
            endDepth:
              type: number
            startDepth:
              type: number
          type: object
        descriptionProcedure:
          type: string
        descriptionQuality:
          type: string
        descriptionReportPeriod:
          properties:
            beginDate:
              type: string
            endDate:
              type: string
          type: object
        determinedCompositionProperties:
          type: string
        determinedHydrophysicalProperties:
          type: string
        discipline:
          type: string
        fieldworkPeriod:
          properties:
            beginDate:
              type: string
            endDate:
              type: string
          type: object
        qualityRegime:
          enum:
          - IMBRO
          - IMBRO_A
          type: string
        registrationPeriod:
          properties:
            beginDate:
              type: string
            endDate:
              type: string
          type: object
        samplingQuality:
          items:
            type: string
          type: array
        underReview:
          enum:
          - JA
          - NEE
          type: string
        volumetricMassDensityDetermined:
          enum:
          - JA
          - NEE
          type: string
        waterContentDetermined:
          enum:
          - JA
          - NEE
          type: string
      required:
      - area
      type: object
    Circle:
      properties:
        center:
          properties:
            lat:
              type: number
            lon:
              type: number
          type: object
        radius:
          type: number
      type: object
    DatePeriod:
      properties:
        beginDate:
          type: string
        endDate:
          type: string
      type: object
    DepthInterval:
      properties:
        endDepth:
          type: number
        startDepth:
          type: number
      type: object
    Envelope:
      properties:
        lowerCorner:
          properties:
            lat:
              type: number
            lon:
              type: number
          type: object
        upperCorner:
          properties:
            lat:
              type: number
            lon:
              type: number
          type: object
      type: object
    Point:
      properties:
        lat:
          type: number
        lon:
          type: number
      type: object
    QualityRegime:
      enum:
      - IMBRO
      - IMBRO_A
      type: string
    ServiceError:
      properties:
        description:
          type: string
        errorCode:
          format: int32
          type: integer
        title:
          type: string
      type: object
    YesNoEnumeration:
      enum:
      - JA
      - NEE
      type: string
info:
  contact:
    email: support@broservicedesk.nl
    name: BRO Servicedesk
    url: https://basisregistratieondergrond.nl/service-contact/
  description: Landelijke Voorziening Basisregistratie Ondergrond (BRO), uitgifte
    en validatie geologisch booronderzoek (BHR-G).
  title: Geologisch Booronderzoek (BHR-G)
  version: 3.197.0
openapi: 3.0.3
paths:
  /sr/bhrg/v3/bro-ids:
    get:
      description: Haalt de lijst van BHR-G bro-ids op waarvoor [bronhouder](https://basisregistratieondergrond.nl/service-contact/formulieren/aangemeld-bro/)
        verantwoordelijk is.
      operationId: bro-ids
      parameters:
      - description: Het kvk (kamer van koophandel) nummer van een BHR-G bronhouder
        example: "12345678"
        in: query
        name: bronhouder
        required: true
        schema:
          type: string
      - description: Registered is een optionele parameter, bij afwezigheid geeft
          deze methode alle BHR-G BRO-IDs terug onafhankelijk of die wel/niet uit
          registratie zijn genomen. <BR>registered = ja geeft alleen BRO-IDs terug
          die in registratie zijn genomen. <BR>registered = nee geeft alleen BRO-IDs
          terug die uit registratie zijn genomen.
        in: query
        name: registered
        schema:
          type: string
      responses:
        "200":
          content:
            application/json: {}
          description: De Lijst van BHR-G BRO-IDs voor dit registratie object type
            waarvoor bronhouder verantwoordelijk is.
          headers:
            API-Version:
              description: Versie van deze BHR-G API
              examples: {}
              schema:
                examples:
                - 3.2.1
                type: string
        "400":
          content:
            application/json:
              schema:
                properties:
                  description:
                    type: string
                  errorCode:
                    format: int32
                    type: integer
                  title:
                    type: string
                type: object
          description: Er bevinden zich andere fouten in het BHR-G verzoek.
          headers:
            API-Version:
              description: Versie van deze BHR-G API
              examples: {}
              schema:
                examples:
                - 3.2.1
                type: string
      summary: Lijst van BHR-G BRO-IDs
  /sr/bhrg/v3/characteristics/searches:
    post:
      description: 'De karakteristieken geven een samenvatting van een object zodat
        een verdere selectie gemaakt kan worden. Het past in een twee-traps-benadering,
        waarbij de eerste stap bestaat uit het ophalen van de karakteristieken en
        de 2e stap uit het ophalen van de gewenste registratie objecten. Het resultaat
        van deze operatie is gemaximaliseerd op 2000. Merk op: deze service leent
        zich niet voor "tiling" (binair geografisch zoeken). Zie [hier](https://www.bro-productomgeving.nl/bpo/latest/bodem-en-grondonderzoek/booronderzoek-bhr/geologisch-booronderzoek-bhr-g/bhr-g-berichtencatalogus-uitgiftewebservice)
        voor meer info.'
      operationId: characteristics
      parameters:
      - description: Een optionele BHR-G referentie van de gebruiker. "-" wordt aangenomen
          bij afwezigheid.
        example: Mijn-aanvraag-000001
        in: query
        name: requestReference
        schema:
          type: string
      requestBody:
        content:
          application/json:
            examples:
              Simple Criteria:
                value: |-
                  {
                    "registrationPeriod": {
                      "beginDate": "2017-01-01",
                      "endDate": "2021-01-01"
                    },
                    "area": {
                      "enclosingCircle": {
                        "center": {
                          "lat": 52.038297852,
                          "lon": 5.31447958948
                        },
                        "radius": 0.5
                      }
                    }
                  }
            schema:
              properties:
                analysisReportPeriod:
                  properties:
                    beginDate:
                      type: string
                    endDate:
                      type: string
                  type: object
                area:
                  properties:
                    boundingBox:
                      properties:
                        lowerCorner:
                          properties:
                            lat:
                              type: number
                            lon:
                              type: number
                          type: object
                        upperCorner:
                          properties:
                            lat:
                              type: number
                            lon:
                              type: number
                          type: object
                      type: object
                    enclosingCircle:
                      properties:
                        center:
                          properties:
                            lat:
                              type: number
                            lon:
                              type: number
                          type: object
                        radius:
                          type: number
                      type: object
                  type: object
                correctionPeriod:
                  properties:
                    beginDate:
                      type: string
                    endDate:
                      type: string
                  type: object
                deliveryAccountableParty:
                  type: string
                depthInterval:
                  properties:
                    endDepth:
                      type: number
                    startDepth:
                      type: number
                  type: object
                descriptionProcedure:
                  type: string
                descriptionQuality:
                  type: string
                descriptionReportPeriod:
                  properties:
                    beginDate:
                      type: string
                    endDate:
                      type: string
                  type: object
                determinedCompositionProperties:
                  type: string
                determinedHydrophysicalProperties:
                  type: string
                discipline:
                  type: string
                fieldworkPeriod:
                  properties:
                    beginDate:
                      type: string
                    endDate:
                      type: string
                  type: object
                qualityRegime:
                  enum:
                  - IMBRO
                  - IMBRO_A
                  type: string
                registrationPeriod:
                  properties:
                    beginDate:
                      type: string
                    endDate:
                      type: string
                  type: object
                samplingQuality:
                  items:
                    type: string
                  type: array
                underReview:
                  enum:
                  - JA
                  - NEE
                  type: string
                volumetricMassDensityDetermined:
                  enum:
                  - JA
                  - NEE
                  type: string
                waterContentDetermined:
                  enum:
                  - JA
                  - NEE
                  type: string
              required:
              - area
              type: object
        description: 'De set van kenmerken. Zie voor meer informatie: https://www.bro-productomgeving.nl/bpo/latest/'
        required: true
      responses:
        "200":
          content:
            application/xml: {}
          description: De set van BHR-G karakteristieken die matched met de criteria
            dan wel een afwijzing.
          headers:
            API-Version:
              description: Versie van deze BHR-G API
              examples: {}
              schema:
                examples:
                - 3.2.1
                type: string
        "400":
          content:
            application/json:
              schema:
                properties:
                  description:
                    type: string
                  errorCode:
                    format: int32
                    type: integer
                  title:
                    type: string
                type: object
          description: Er bevinden zich andere fouten in het BHR-G verzoek.
          headers:
            API-Version:
              description: Versie van deze BHR-G API
              examples: {}
              schema:
                examples:
                - 3.2.1
                type: string
      summary: Haalt de karakteristieken op van een set van registratie objecten,
        gegeven een kenmerkenverzameling (kenset).
  /sr/bhrg/v3/objects/{broId}:
    get:
      description: Haal een geologisch booronderzoek op op basis van een BRO-ID. De
        operatie retourneert een object op basis van het BRO-ID als een 'O' (actuele
        situatie), of 'DO' (uit registratie) als IMBRO XML. De andere variant 'O-DP'
        is niet ondersteund omdat hier authenticatie / autorisatie voor nodig is (er
        worden bronhouder gevoelige gegevens terug gegeven). Gebruik hiervoor de 'DigiKoppeling'
        webservice. Zie [hier](https://www.bro-productomgeving.nl/bpo/latest/bodem-en-grondonderzoek/booronderzoek-bhr/geologisch-booronderzoek-bhr-g/bhr-g-berichtencatalogus-uitgiftewebservice)
        voor meer info.
      operationId: objects
      parameters:
      - content:
          text/plain:
            schema:
              type: string
        description: Het BRO-ID van het BHR-G object.
        in: path
        name: broId
        required: true
      - description: Een optionele BHR-G referentie van de gebruiker. "-" wordt aangenomen
          bij afwezigheid.
        example: Mijn-BHRG-object-aanvraag-000001
        in: query
        name: requestReference
        schema:
          type: string
      responses:
        "200":
          content:
            application/xml: {}
          description: Het aangevraagde registratie object dan wel een afwijzing van
            het BHR-G verzoek.
          headers:
            API-Version:
              description: Versie van deze BHR-G API
              examples: {}
              schema:
                examples:
                - 3.2.1
                type: string
        "400":
          content:
            application/json:
              schema:
                properties:
                  description:
                    type: string
                  errorCode:
                    format: int32
                    type: integer
                  title:
                    type: string
                type: object
          description: Er bevinden zich andere fouten in het BHR-G verzoek.
          headers:
            API-Version:
              description: Versie van deze BHR-G API
              examples: {}
              schema:
                examples:
                - 3.2.1
                type: string
      summary: Haalt een geologisch booronderzoek (geotechnical borehole research
        survey, bhr-g) op op basis van een BRO-ID
