> ## Documentation Index > Fetch the complete documentation index at: https://help.withallo.com/llms.txt > Use this file to discover all available pages before exploring further. # Obtenir le prix d'un numéro > Returns what adding one more number to the account costs today. When the account already pays for a free number slot, `included` is `true` and `amount_due_now` is `0`. Otherwise `amount_due_now` is the charge for the rest of the account's current billing period, net of the subscription's discount, tax included. Requires the `PARTNER` scope. **Scope requis :** `PARTNER` Renvoie ce que coûte aujourd'hui un numéro de plus sur le compte. Appelez-le avant [Ajouter un numéro](/fr/v2/api-reference/partner/add-number) pour afficher ou vérifier le prix. * `included` vaut `true` quand le compte paie déjà un emplacement de numéro qu'aucun numéro n'occupe. Le prochain numéro ne coûte alors rien, et `amount_due_now` vaut `0`. * `amount_due_now` est le montant qu'Allo débite à l'ajout du numéro : le reste de la période de facturation en cours du compte, avec la remise de l'abonnement appliquée, taxes comprises. * `unit_amount_before_discount` est le prix d'un numéro pour une période de facturation complète, avant toute remise. * Les montants sont exprimés dans la plus petite unité de `currency` (centimes pour EUR et USD). `currency` est en minuscules, par exemple `eur`. * `interval` est la périodicité de facturation de l'abonnement du compte : `MONTHLY` ou `YEARLY`. * Un compte que votre API key n'a pas créé, ou déjà désactivé, renvoie `404 PARTNER_ACCOUNT_NOT_FOUND`. Le prix évolue au fil de la période de facturation, car le montant ne couvre que les jours restants. Relisez-le juste avant d'ajouter le numéro. ## OpenAPI ````yaml GET /v2/api/partner/accounts/{id}/numbers/price openapi: 3.0.3 info: title: Allo API description: >- Allo API provides programmatic access to your Allo account, allowing you to manage webhooks, retrieve calls and contacts, and send SMS messages. All requests to `/v1/api/**` endpoints automatically go through quota checking and scope validation. version: 1.0.0 contact: name: Allo Support servers: - url: https://api.withallo.com description: Production server security: [] tags: - name: Summary Templates description: >- Manage call summary templates that control how AI-generated call summaries are structured for your team. - name: Webhooks description: >- Manage webhook endpoints to receive real-time notifications about events in your Allo account. Each endpoint subscribes to one or more event topics and is verified with a signing secret. - name: Calls description: >- Retrieve and search call records with filtering and pagination. Filter calls by your Allo phone number. - name: Contacts description: >- Search and retrieve contact information with sorting and pagination. Includes engagement level tracking. - name: SMS description: Send SMS messages to phone numbers using your Allo numbers. - name: Phone Numbers description: Retrieve information about your Allo phone numbers. - name: Analytics description: Pre-computed call metrics, team performance, and outbound dial funnel - name: CRM description: Manage people, companies, and deals in your CRM. - name: Notes description: >- Internal team notes on conversations and CRM people, with @mention support. Notes are never visible to the contact. - name: Threads description: >- Team discussion threads attached to a conversation item (call, SMS, or conversation note). One thread per item. - name: AI Receptionist description: >- Read and write the AI receptionist configuration of a phone line: business details, voice, prompt, capabilities, business hours, transfer rules, scheduling calendars and knowledge sources. paths: /v2/api/partner/accounts/{id}/numbers/price: get: tags: - Partner summary: Get number price description: >- Returns what adding one more number to the account costs today. When the account already pays for a free number slot, `included` is `true` and `amount_due_now` is `0`. Otherwise `amount_due_now` is the charge for the rest of the account's current billing period, net of the subscription's discount, tax included. Requires the `PARTNER` scope. operationId: getPartnerAccountNumberPrice parameters: - name: id in: path required: true schema: type: string description: The account id returned by Create account (`usr-*`). responses: '200': description: Price of one more number content: application/json: schema: type: object properties: data: type: object properties: included: type: boolean description: >- `true` when the account already pays for a number slot that no number uses: the next number costs nothing. example: false unit_amount_before_discount: type: integer format: int64 description: >- The price of one number for a full billing period, before discount, in the smallest currency unit. example: 1000 amount_due_now: type: integer format: int64 description: >- What Allo charges when you add the number: prorated to the end of the current period, net of the subscription's discount, tax included. `0` when `included` is `true`. example: 540 currency: type: string description: Lowercase ISO 4217 code of the account's subscription. example: eur interval: type: string enum: - MONTHLY - YEARLY description: Billing interval of the account's subscription. example: MONTHLY example: data: included: false unit_amount_before_discount: 1000 amount_due_now: 540 currency: eur interval: MONTHLY '401': $ref: '#/components/responses/ApiUnauthorized' '402': description: >- The account has no subscription Allo can bill (PARTNER_SUBSCRIPTION_NOT_BILLABLE). content: application/json: schema: type: object properties: error: type: object '403': description: The API key lacks the PARTNER scope. content: application/json: schema: type: object properties: error: type: object '404': description: >- No account with this id was provisioned by your API key, or the account is deactivated (PARTNER_ACCOUNT_NOT_FOUND). content: application/json: schema: type: object properties: error: type: object '429': $ref: '#/components/responses/ApiRateLimited' '500': description: >- Billing is temporarily unavailable (PARTNER_BILLING_UNAVAILABLE). Retry in a few seconds. content: application/json: schema: type: object properties: error: type: object security: - ApiKeyAuth: [] components: responses: ApiUnauthorized: description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiRateLimited: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' schemas: ApiError: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string retryable: type: boolean request_id: type: string retry_after_seconds: type: integer nullable: true securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.