Discovery needs no key. Ratings and market analysis are Pro.
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.
openapi: 3.2.0
info:
title: Finalcad One Project Meetings API
version: '2.41'
summary: 'Project-level operations for Finalcad One construction projects: project details, project libraries, members, locations (folders / plans / IFC), discussion groups, companies, modules (observations / forms / meetings), observations, forms and form answers, documents, phases, meetings and XLSX/PDF exports.'
description: 'Project-level operations for Finalcad One construction projects: project details, project libraries, members, locations (folders / plans / IFC), discussion groups, companies, modules (observations / forms / meetings), observations, forms and form answers, documents, phases, meetings and XLSX/PDF exports.
DERIVED, NOT PUBLISHED BY THE PROVIDER. Finalcad publishes no OpenAPI. This document was mechanically derived by API Evangelist from the first-party public Postman collection "Finalcad One API" served by Finalcad at https://developer.finalcad.com/ (collection JSON: https://developer.finalcad.com/api/collections/10995648/Tz5v1Es2), saved in this repo at collections/finalcad.postman_collection.json. Every path, method, header, query parameter, example request body and example response below is carried over from that collection; nothing was invented. Request/response bodies are typed as generic objects because the collection carries examples, not schemas. Four Finalcad employees'' personal e-mail addresses that appeared in the collection''s example payloads were replaced with placeholders; nothing else was changed.'
contact:
name: Finalcad One API — developer portal
url: https://developer.finalcad.com/
x-generated-by: API Evangelist enrichment pipeline (derived from the first-party Postman collection)
x-source: collections/finalcad.postman_collection.json
x-source-url: https://developer.finalcad.com/
servers:
- url: https://developer.finalcad.cloud/api
description: Production — the baseUrl variable published in the Finalcad One API Postman collection.
- url: https://developer.sandbox.finalcad.cloud/api
description: Sandbox — published by Finalcad in the 'Retrieve data in Power BI' tutorial of the same collection.
security:
- apiKey: []
tokenAuth: []
tags:
- name: Meetings
paths:
/projects/{project_id}/meetings:
get:
operationId: meetingsGetMeetings
summary: Get meetings
description: "Get the list of meetings for a given project.\n\n Details \n\n project_Id \n the id of the project to be modified \n\n Query params optionals \n\n see Commmon behaviors / differential"
tags:
- Meetings
parameters:
- name: project_id
in: path
required: true
schema:
type: string
description: Path variable `project_id` as published in the collection.
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
examples:
Success:
value:
meetings:
- id: ed0c4147-c6b5-49e8-acc8-4c23a1368dc2
description: meet1
meeting_start_date: '2024-05-30T13:22:55Z'
meeting_end_date: '2024-05-30T15:22:55Z'
client_created_at: '2024-05-29T07:23:27.772Z'
client_updated_at: '2024-05-29T07:23:27.772Z'
created_at: '2024-05-29T07:23:28.087017Z'
created_by: 25ff0593-dd4c64d0-1579-4354-8a2b-260b34025b6a
updated_at: '2024-05-29T07:23:28.087017Z'
updated_by: 25ff0593-dd4c64d0-1579-4354-8a2b-260b34025b6a
- id: 83ae1a12-809f-4bbd-92fd-91c516ec9d13
description: meet1
meeting_start_date: '2024-05-30T13:22:55Z'
meeting_end_date: '2024-05-30T15:22:55Z'
client_created_at: '2024-05-29T07:23:48.21Z'
client_updated_at: '2024-05-29T07:23:48.21Z'
created_at: '2024-05-29T07:23:48.519077Z'
created_by: 25ff0593-dd4c64d0-1579-4354-8a2b-260b34025b6a
updated_at: '2024-05-29T07:23:48.519077Z'
updated_by: 25ff0593-dd4c64d0-1579-4354-8a2b-260b34025b6a
need_to_relaunch: true
continuous_token: 0|2
count: 2
total_count: 5
'400':
description: Bad Request — an `api_code` static error code and message envelope. See errors/finalcad-problem-types.yml.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'401':
description: Unauthorized — the API key or user token is missing or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Server error — a constructed `{ProcessCode}_ERR{n}` api_code envelope.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
/projects/{project_id}/meetings/{meeting_id}:
get:
operationId: meetingsGetMeetingDetails
summary: Get meeting details
description: "Get the details of a specific meeting for a given project.\n\n Details \n\n project_Id \n the id of the project to be modified \n\n meeting_id \n id of the meeting"
tags:
- Meetings
parameters:
- name: project_id
in: path
required: true
schema:
type: string
description: Path variable `project_id` as published in the collection.
- name: meeting_id
in: path
required: true
schema:
type: string
description: Path variable `meeting_id` as published in the collection.
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
examples:
Success:
value:
id: 336a8f8e-17b9-4d94-8a81-33a85861888f
description: Reu 1
meeting_start_date: '2023-04-05T07:51:19.4Z'
meeting_end_date: '2023-04-05T09:51:19.4Z'
client_created_at: '2023-04-05T07:51:29.24Z'
client_updated_at: '2023-04-05T07:52:36.470651Z'
export_status: Success
export_media_resource:
id: 3e56a79d-81e2-46af-9f7e-5606d279319a
file_name: TestFormsAnswer-Reu1-2023-04-05-09-52-23-568
mime_type: application/pdf
created_at: '2023-04-05T07:52:36.473358Z'
created_at: '2023-04-05T07:51:29.571677Z'
created_by: 25ff0593-dd4c64d0-1579-4354-8a2b-260b34025b6a
updated_at: '2023-04-05T07:52:36.475478Z'
updated_by: 25ff0593-dd4c64d0-1579-4354-8a2b-260b34025b6a
'400':
description: Bad Request — an `api_code` static error code and message envelope. See errors/finalcad-problem-types.yml.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'401':
description: Unauthorized — the API key or user token is missing or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Server error — a constructed `{ProcessCode}_ERR{n}` api_code envelope.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
components:
schemas:
ApiError:
type: object
description: Finalcad One error envelope. `api_code` is either a static code (mostly 4xx, e.g. INVALID_INSTANCE_STATE) or a constructed code of the form {ProcessCode}_ERR{n} / {ProcessCode}_WRN{n} (mostly 5xx).
properties:
statut:
type: integer
description: HTTP status code, repeated in the body (spelled `statut`).
api_code:
type: string
description: Internal Finalcad API error code.
message:
type: string
description: Short explanation of the abnormality encountered.
data:
type: object
description: Complementary data to help understand the error.
additionalProperties: true
securitySchemes:
apiKey:
type: apiKey
in: header
name: X-API-Key
description: Organization API key issued by Finalcad to organizations on an Enterprise licence. Sent on every call.
tokenAuth:
type: apiKey
in: header
name: Authorization
description: '`Authorization: token <your_api_key>`, or `Authorization: bearer <user_token>` for the legacy user-token flow (POST /auth).'