find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/comunicate-eu:comunicate-eu-balance-and-reports-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Comunicate Eu Balance and reports API
  version: 1.0.0
  contact:
    url: https://comunicate.eu/ro/contact
  description: 'Operations tagged Balance and reports across 2 of this provider''s published API definitions: comunicate-eu-openapi.json, comunicate-eu-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://app.comunicate.eu/api/v1
tags:
- name: Balance and reports
paths:
  /partner/balance:
    get:
      operationId: get_balance
      summary: Available balance
      description: 'The packages you own, with the credit left on each, and the money balance. Check it before requesting a publication — otherwise the integration finds out from an error, after it has already built the article.


        `available` subtracts reservations: a publication in flight has already locked the credit, even if it has not consumed it.


        Required scope: `BALANCE_READ`.'
      tags:
      - Balance and reports
      parameters: []
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
                credits:
                - packageTypeId: c1…
                  packageName: Pachet Regional 20
                  available: 14
                  total: 20
                money:
                  availableCents: 125000
                  currency: RON
        '400':
          description: Invalid input
        '401':
          description: Missing or invalid API key
        '403':
          description: The key lacks the required scope
      security:
      - apiKey: []
      - oauth2:
        - BALANCE_READ
      x-codeSamples:
      - lang: Shell
        label: curl
        source: "curl --location 'https://app.comunicate.eu/api/v1/partner/balance' \\\n  --header 'Authorization: Bearer bk_live_…'"
    servers:
    - url: https://app.comunicate.eu/api/v1
  /partner/reports/summary:
    get:
      operationId: get_reports_summary
      summary: Period summary
      description: 'Defaults to the last 30 days. An integration that sends no range gets something useful, not the entire history.


        Required scope: `REPORTS_READ`.'
      tags:
      - Balance and reports
      parameters:
      - name: from
        in: query
        required: false
        description: Range start.
        schema:
          type: string
          format: date
      - name: to
        in: query
        required: false
        description: Range end.
        schema:
          type: string
          format: date
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
                from: '2026-08-01T00:00:00.000Z'
                to: '2026-08-31T00:00:00.000Z'
                publications: 42
                published: 39
                failed: 3
                distinctSites: 21
                creditsUsed: 18
                moneySpentCents: 372000
                successRate: 0.93
        '400':
          description: Invalid input
        '401':
          description: Missing or invalid API key
        '403':
          description: The key lacks the required scope
      security:
      - apiKey: []
      - oauth2:
        - REPORTS_READ
      x-codeSamples:
      - lang: Shell
        label: curl
        source: "curl --location 'https://app.comunicate.eu/api/v1/partner/reports/summary?from=2026-08-01&to=2026-08-31' \\\n  --header 'Authorization: Bearer bk_live_…'"
    servers:
    - url: https://app.comunicate.eu/api/v1
  /partner/reports/publications:
    get:
      operationId: get_reports_publications
      summary: Publications in range
      description: 'Row by row, for reporting to the client.


        Required scope: `REPORTS_READ`.'
      tags:
      - Balance and reports
      parameters: []
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
              - publishedAt: '2026-08-14T09:02:00.000Z'
                article: Ce verifici la o firmă de amenajări
                site: exemplu.ro
                url: https://exemplu.ro/articol
                campaign: Client Exemplu — Q3
        '400':
          description: Invalid input
        '401':
          description: Missing or invalid API key
        '403':
          description: The key lacks the required scope
      security:
      - apiKey: []
      - oauth2:
        - REPORTS_READ
      x-codeSamples:
      - lang: Shell
        label: curl
        source: "curl --location 'https://app.comunicate.eu/api/v1/partner/reports/publications?from=2026-08-01' \\\n  --header 'Authorization: Bearer bk_live_…'"
    servers:
    - url: https://app.comunicate.eu/api/v1
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: API key from Integrations (bk_live_…)
    oauth2:
      type: oauth2
      description: OAuth 2.1 with PKCE (S256). Dynamic client registration at https://app.comunicate.eu/api/v1/oauth/register. The access token is an API key and is accepted everywhere an API key is.
      flows:
        authorizationCode:
          authorizationUrl: https://app.comunicate.eu/api/v1/oauth/authorize
          tokenUrl: https://app.comunicate.eu/api/v1/oauth/token
          refreshUrl: https://app.comunicate.eu/api/v1/oauth/token
          scopes:
            CATALOG_READ: catalog read
            ARTICLES_READ: articles read
            ARTICLES_WRITE: articles write
            MEDIA_WRITE: media write
            PUBLICATIONS_READ: publications read
            PUBLICATIONS_WRITE: publications write
            CAMPAIGNS_READ: campaigns read
            CAMPAIGNS_WRITE: campaigns write
            BALANCE_READ: balance read
            REPORTS_READ: reports read
x-refined-from:
- comunicate-eu-openapi.json
- comunicate-eu-openapi.json
x-provenance:
  method: harvested
  publisher: Comunicate.eu
  source: https://app.comunicate.eu/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)