GEMI General Commercial Registry (Greece) Companies API

openapi: 3.2.0
info:
  title: Businessportal Gr Companies API
  version: 1.0.0
  contact:
    email: support@uhc.gr
  license:
    name: ODC-BY-1.0
    url: http://www.opendefinition.org/licenses/odc-by
  termsOfService: https://opendata.businessportal.gr
  description: 'Operations tagged Companies across 2 of this provider''s published API definitions: businessportal-gr-opendata-swagger.json, businessportal-gr-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://opendata-api.businessportal.gr/api/opendata/v1
tags:
- name: Companies
  description: Επιχειρήσεις μέλη ΓΕΜΗ
paths:
  /companies/{arGemi}:
    get:
      tags:
      - Companies
      summary: Στοιχεία Επιχείρησης με βάση τον Αριθμό ΓΕΜΗ
      description: Επιστρέφει τα στοιχεία της Επιχείρησης
      operationId: getCompanyByArGemi
      parameters:
      - name: arGemi
        in: path
        description: ο Αριθμός ΓΕΜΗ της Επιχείρησης
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: Επιτυχία
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Company'
        '400':
          description: Πρόβλημα με τα στοιχεία που έστειλε ο API client
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ErrorEntry'
        '404':
          description: Δεν βρέθηκε εταιρεία
        '500':
          description: Internal Error
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ErrorEntry'
        '503':
          description: Υπερφορτωμένο ή μη διαθέσιμο σύστημα
      security:
      - api_key: []
      x-swagger-router-controller: Companies
    servers:
    - url: https://opendata-api.businessportal.gr/api/opendata/v1
  /companies:
    get:
      tags:
      - Companies
      summary: Αναζήτηση εταιρειών με κριτήρια
      description: 'Επιστρέφει τις Επιχειρήσεις που πληρούν τα κριτήρια αναζήτησης.

        - Πρέπει να εισαχθεί τουλάχιστον ένα κριτήριο.

        - Λογικό AND αν εισαχθούν πάνω από ένα κριτήρια.

        - Κριτήρια τύπου array εισάγονται με κόμμα (π.χ. 1,2,3)'
      operationId: getCompaniesByCriteria
      parameters:
      - name: arGemi
        in: query
        required: false
        description: Αριθμός ΓΕΜΗ της Επιχείρησης
        schema:
          type: string
      - name: afm
        in: query
        required: false
        description: ΑΦΜ της Επιχείρησης. Αρχικά 0 πρέπει να εισάγονται ώστε πάντα να είναι 9-ψήφιος αριθμός
        schema:
          type: string
          maxLength: 9
          minLength: 9
      - name: name
        in: query
        required: false
        description: Λεκτικό αναζήτησης τόσο για επωνυμία όσο και διακριτικό τίτλο.
        schema:
          type: string
          minLength: 3
      - name: legalTypes
        in: query
        required: false
        description: μία ή περισσότερες νομικές μορφές (id's)
        schema:
          type: array
          items:
            type: integer
      - name: gemiOffices
        in: query
        required: false
        description: μία ή περισσότερες ΤΥ ΓΕΜΗ (id's)
        schema:
          type: array
          items:
            type: string
      - name: municipalities
        in: query
        required: false
        description: ένας ή περισσότεροι Δήμοι (id's)
        schema:
          type: array
          items:
            type: string
      - name: prefectures
        in: query
        required: false
        description: ένας ή περισσότεροι Νομοί (id's)
        schema:
          type: array
          items:
            type: integer
      - name: statuses
        in: query
        required: false
        description: μία ή περισσότερες καταστάσεις επιχείρησης (id's)
        schema:
          type: array
          items:
            type: integer
      - name: isActive
        in: query
        required: false
        description: ενεργή ή μη εταιρεία
        schema:
          type: boolean
      - name: activities
        in: query
        required: false
        description: μία ή περισσότερες δραστηριότητες (id's)
        schema:
          type: array
          items:
            type: string
      - name: resultsSortBy
        in: query
        required: false
        description: Πεδίο βάσει του οποίου θα γίνει η ταξινόμηση. Το + υποδηλώνει αύξουσα σειρά, το - φθίνουσα
        schema:
          type: string
          enum:
          - +coName
          - -coName
          - +afm
          - -afm
          - +arGemi
          - -arGemi
          - +incorporationDate
          - -incorporationDate
          default: +arGemi
      - name: resultsOffset
        in: query
        required: false
        description: Θέση απο την οποία να επιστραφούν αποτελέσματα για το τρέχον request, αρχίζει απο 0
        schema:
          type: integer
          default: 0
          minimum: 0
      - name: resultsSize
        in: query
        required: false
        description: Πλήθος αποτελεσμάτων που ζητούνται στο τρέχον request. Μέγιστο 200.
        schema:
          type: integer
          default: 10
          maximum: 200
          minimum: 1
      responses:
        '200':
          description: Επιτυχία
          content:
            application/json:
              schema:
                type: object
                properties:
                  searchMetadata:
                    type: object
                    properties:
                      totalCount:
                        type: integer
                        description: πλήθος επιχειρήσεων που πληρούν τα κριτήρια
                      resultsOffset:
                        type: integer
                        description: Offset αποτελεσμάτων σε αυτό το result
                      resultsSize:
                        type: string
                        description: αποτελέσματα που έρχονται σε αυτό το result
                  searchResults:
                    type: array
                    items:
                      $ref: '#/components/schemas/Company'
        '400':
          description: Πρόβλημα με τα στοιχεία που έστειλε ο API client
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ErrorEntry'
        '404':
          description: Δεν βρέθηκε εταιρεία
        '500':
          description: Internal Error
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ErrorEntry'
        '503':
          description: Υπερφορτωμένο ή μη διαθέσιμο σύστημα
      security:
      - api_key: []
      x-swagger-router-controller: Companies
    servers:
    - url: https://opendata-api.businessportal.gr/api/opendata/v1
  /companies/{arGemi}/documents:
    get:
      tags:
      - Companies
      summary: Δημόσια έγγραφα Επιχείρησης
      description: Επιστρέφει τα δημόσια έγγραφα της Επιχείρησης (καταστατικό, ανακοινώσεις ΓΕΜΗ κοκ)
      operationId: getCompanyDocumentsByArGemi
      parameters:
      - name: arGemi
        in: path
        description: ο Αριθμός ΓΕΜΗ της Επιχείρησης
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: Επιτυχία
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyDocumentSet'
        '400':
          description: Πρόβλημα με τα στοιχεία που έστειλε ο API client
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ErrorEntry'
        '404':
          description: Δεν βρέθηκαν αποτελέσματα
        '500':
          description: Internal Error
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ErrorEntry'
        '503':
          description: Υπερφορτωμένο ή μη διαθέσιμο σύστημα
      security:
      - api_key: []
      x-swagger-router-controller: Companies
    servers:
    - url: https://opendata-api.businessportal.gr/api/opendata/v1
components:
  schemas:
    CompanyDocumentDecision:
      type: object
      properties:
        dateAssemblyDecided:
          type: string
          format: date
          description: Ημ/νία απόφασης Οργάνου
        assembly:
          type: string
          description: Είδος οργάνου
        summary:
          type: string
          description: περίληψη θέματος
        kak:
          type: string
          description: Κωδικός Αριθμός Καταχώρισης
        decisionSubject:
          type: string
          description: Θέμα Απόφασης
        decisionSubjectID:
          type: string
          description: Κωδικός Θέματος Απόφασης
        dateAnnounced:
          type: string
          format: date
          description: Ημ/νια Ανακοίνωσης
        assemblyDecisionUrl:
          type: string
          description: Αρχείο Ανακοίνωσης
        dateRegistrated:
          type: string
          format: date
          description: Ημ/νια Ολοκλήρωσης Καταχώρισης
        applicationStatusId:
          type: string
          description: Κωδικός Κατάστασης Αίτησης
        applicationStatusDescription:
          type: string
          description: Περιγραφή Κατάστασης Αίτησης
        referenceKak:
          type: string
          description: Κωδικός Αριθμός Καταχώρισης Που Οδηγεί Σε Διόρθωση/Ανάκληση
      description: Έγγραφα Ανακοίνωσης ΓΕΜΗ
    CompanyDocumentPublication:
      type: object
      properties:
        url:
          type: string
          description: url εγγράφου ΥΜΣ
        kad:
          type: string
          description: Κωδικός Αριθμός Δημοσίευσης ΥΜΣ
      description: Έγγραφα Σύστασης από ΥΜΣ
    CompanyDocumentSet:
      type: object
      properties:
        decision:
          type: array
          items:
            $ref: '#/components/schemas/CompanyDocumentDecision'
        publication:
          type: array
          items:
            $ref: '#/components/schemas/CompanyDocumentPublication'
    ErrorEntry:
      type: object
      properties:
        code:
          type: string
          description: κωδικός
        message:
          type: string
          description: περιγραφή
      description: Σφάλμα που επιστρέφει το σύστημα
    Company:
      type: object
      properties:
        arGemi:
          type: integer
          description: Αριθμός ΓΕΜΗ
        afm:
          type: string
          description: ΑΦΜ
        coNameEl:
          type: string
          description: Επωνυμία (Ελληνικά)
        coNamesEn:
          type: array
          description: Επωνυμίες (με Λατινικούς χαρακτήρες)
          items:
            type: string
        coTitlesEl:
          type: array
          description: Διακριτικοί τίτλοι(Ελληνικά)
          items:
            type: string
        coTitlesEn:
          type: array
          description: Διακριτικοί τίτλοι (με Λατινικούς χαρακτήρες)
          items:
            type: string
        municipality:
          description: Δήμος
          type: object
          properties:
            id:
              type: integer
              description: κωδικός
            descr:
              type: string
              description: περιγραφή
        prefecture:
          description: Νομός
          type: object
          properties:
            id:
              type: integer
              description: κωδικός
            descr:
              type: string
              description: περιγραφή
        city:
          type: string
          description: Πόλη
        street:
          type: string
          description: 'Διεύθυνση: Οδός'
        streetNumber:
          type: string
          description: 'Διεύθυνση: Αριθμός'
        zipCode:
          type: string
          description: ΤΚ
        poBox:
          type: string
          description: Ταχυδρομική θυρίδα
        url:
          type: string
          description: Web site
        email:
          type: string
          description: Email Επιχείρησης
        isBranch:
          type: boolean
          description: "Αν true, τότε η εταιρεία είναι Υποκατάστημα\n Αν false, τότε είναι Μητρική\n"
          default: false
        objective:
          type: string
          description: Σκοπός εταιρείας
        legalType:
          description: Νομική μορφή
          type: object
          properties:
            id:
              type: integer
              description: κωδικός
            descr:
              type: string
              description: περιγραφή
        gemiOffice:
          description: Τοπική υπηρεσία ΓΕΜΗ
          type: object
          properties:
            id:
              type: integer
              description: κωδικός
            descr:
              type: string
              description: περιγραφή
        assemblySubjects:
          description: Θέματα Αποφάσεων ΓΕΜΗ
          type: object
          properties:
            id:
              type: integer
              description: κωδικός
            descr:
              type: string
              description: περιγραφή
        incorporationDate:
          type: string
          format: date
          description: Ημερομηνία σύστασης / ίδρυσης
        lastStatusChange:
          type: string
          format: date
          description: Ημερομηνία αλλαγής κατάστασης
        status:
          description: Κατάσταση Επιχείρησης
          type: object
          properties:
            id:
              type: integer
              description: κωδικός
            descr:
              type: string
              description: περιγραφή
        autoRegistered:
          type: boolean
          description: 'Αν false, τότε η εταιρεία δεν έχει ολοκληρώσει την αυτοαπογραφή της.

            Σε αυτή την περίπτωση τα δεδομένα που επιστρέφονται είναι ελλειπή

            '
          default: true
        activities:
          type: array
          description: Δραστηριότητες Επιχείρησης
          items:
            $ref: '#/components/schemas/CompanyActivity'
        persons:
          type: array
          description: Πρόσωπα Επιχείρησης
          items:
            $ref: '#/components/schemas/CompanyPerson'
        capital:
          type: array
          description: Στοιχεία Κεφαλαίου Επιχείρησης
          items:
            type: object
            properties:
              capitalStock:
                type: number
                description: Κεφάλαιο
              currency:
                type: string
                description: Νόμισμα
              ecsokefalaiikes:
                type: number
                description: Εξωλογιστικά Κεφάλαια
              eggiitikes:
                type: number
                description: Εγγυητικά Κεφάλαια
        stocks:
          type: array
          description: Στοιχεία Μετοχών Επιχείρησης
          items:
            type: object
            properties:
              stockTypeId:
                type: number
                description: Τύπος Μετοχής ID
              amount:
                type: number
                description: Ποσότητα
              nominalPrice:
                type: number
                description: Ονομαστική Τιμή
              stockType:
                type: string
                description: Τύπος Μετοχής
        branch:
          type: array
          description: Στοιχεία Υποκαταστήματος
          items:
            type: integer
      description: Τα δημόσια στοιχεία μιας Επιχείρησης - μέλος του ΓΕΜΗ
    CompanyPerson:
      type: object
      properties:
        personName:
          type: string
          description: στοιχεία φυσικού προσώπου
        businessName:
          type: string
          description: στοιχεία νομικού προσώπου
        role:
          type: string
          description: ρόλος προσώπου στην εταιρεία
        dtFrom:
          type: string
          format: date
          description: ημερομηνία ισχύος του ρόλου από
        dtTo:
          type: string
          format: date
          description: ημερομηνία ισχύος του ρόλου έως
        isRepresentativeAlone:
          type: boolean
          description: Εκπροσώπηση μεμονωμένα
        isRepresentativeInCommon:
          type: boolean
          description: Εκπροσώπηση από κοινού
        percentage:
          type: string
          description: Ποσοστό
        category:
          type: string
          description: Κατηγορία
      description: 'Στοιχεία συσχετισμού φυσικών και νομικών προσώπων με την εταιρεία

        Μόνο ένα από τα `personName` και `businessName` είναι μη κενά σε κάθε αντικείμενο, υποδηλώνοντας φυσικό ή νομικό πρόσωπο αντίστοιχα

        '
    CompanyActivity:
      type: object
      properties:
        activity:
          type: object
          properties:
            id:
              type: string
              description: κωδικός δραστηριότητας (ΚΑΔ)
            descr:
              type: string
              description: περιγραφή δραστηριότητας (ΚΑΔ)
            kadVersion:
              type: string
              description: ΚΑΔ version 2008 ή 2026
        type:
          type: string
          description: τύπος δραστηριότητας για την εταιρεία
        dtFrom:
          type: string
          format: date
          description: ημερομηνία ισχύος από
        dtTo:
          type: string
          format: date
          description: ημερομηνία ισχύος έως
  securitySchemes:
    api_key:
      type: apiKey
      name: api_key
      in: header
externalDocs:
  description: Σχετικά με το ΓΕΜΗ
  url: http://www.businessportal.gr
x-refined-from:
- businessportal-gr-opendata-swagger.json
- businessportal-gr-openapi.yml