> ## Documentation Index > Fetch the complete documentation index at: https://docs.apollodeploy.com/llms.txt > Use this file to discover all available pages before exploring further. # Get deliverability advisor > Returns the current deliverability score and actionable recommendations for the authenticated project. ### Requirements - **Permission:** `emails:send` or `emails:read` or `metrics:read`. - **HTTP rate limit:** 120 requests per 60 seconds per API key. ## OpenAPI ````yaml /signal/api-reference/openapi.json get /v1/metrics/advisor openapi: 3.1.0 info: title: Apollo Signal API version: 1.0.0 description: >- Public REST API for transactional email, contacts, audiences, webhooks, metrics, projects, and sending domains. servers: - url: https://api.signal.apollodeploy.com description: Production security: [] tags: - name: Emails description: Send, inspect, cancel, validate, and stream transactional email activity. - name: Metrics description: Read project, topic, message, and deliverability analytics. - name: Suppressions description: Manage addresses that Apollo Signal must not send to. - name: Segments description: Create dynamic contact groups and inspect their membership. - name: Topics description: Manage subscription topics and topic membership. - name: Contact properties description: Define the custom fields available on project contacts. - name: Contacts description: >- Manage contacts, audience membership, images, activity, and engagement data. - name: Webhooks description: Manage webhook endpoints, deliveries, tests, and replays. - name: API key usage description: Inspect API key metadata and request usage without exposing raw keys. - name: Projects description: Inspect projects and project-scoped email logs. - name: Sending domains description: >- Register, verify, inspect, and remove sending domains and BIMI configuration. paths: /v1/metrics/advisor: get: tags: - Metrics summary: Get deliverability advisor description: >- Returns the current deliverability score and actionable recommendations for the authenticated project. ### Requirements - **Permission:** `emails:send` or `emails:read` or `metrics:read`. - **HTTP rate limit:** 120 requests per 60 seconds per API key. operationId: getMetricsAdvisor parameters: - name: projectId in: query description: Required for session auth; ignored for API key auth. required: false deprecated: false explode: false schema: type: string title: String responses: '200': headers: {} content: application/json: schema: $ref: >- #/components/schemas/com.apollodeploy.signal.feature.deliverability.api.model.AdvisorReportResponse description: Request completed successfully. '401': headers: {} content: application/problem+json: schema: $ref: >- #/components/schemas/com.apollodeploy.commons.core.error.ApiProblem description: >- The API key or stream token is missing, invalid, expired, or inactive. '403': description: >- The credential lacks the required permission or cannot access this project. headers: {} content: application/problem+json: schema: $ref: >- #/components/schemas/com.apollodeploy.commons.core.error.ApiProblem '429': description: >- The endpoint rate limit was exceeded. Wait for the `Retry-After` interval before retrying. headers: Retry-After: description: Whole seconds to wait before retrying. schema: type: integer minimum: 1 content: application/problem+json: schema: $ref: >- #/components/schemas/com.apollodeploy.commons.core.error.ApiProblem deprecated: false security: - bearerAuth: [] components: schemas: com.apollodeploy.signal.feature.deliverability.api.model.AdvisorReportResponse: type: object properties: generatedAt: type: string title: String projectId: type: string title: String recommendations: type: array items: $ref: >- #/components/schemas/com.apollodeploy.signal.feature.deliverability.api.model.AdvisorRecommendationResponse title: List score: type: integer format: int32 title: Int required: - generatedAt - projectId - recommendations - score title: AdvisorReportResponse com.apollodeploy.commons.core.error.ApiProblem: type: object properties: code: type: string title: ErrorCode detail: type: string title: String errors: type: array items: $ref: >- #/components/schemas/com.apollodeploy.commons.core.error.FieldProblem title: List instance: type: string title: ProblemInstance requestId: type: string title: String status: type: integer format: int32 title: Int title: type: string title: String type: type: string title: ProblemType required: - code - status - title - type title: ApiProblem com.apollodeploy.signal.feature.deliverability.api.model.AdvisorRecommendationResponse: type: object properties: code: type: string title: String data: $ref: >- #/components/schemas/com.apollodeploy.signal.feature.deliverability.api.model.AdvisorRecommendationDataResponse message: type: string title: String severity: type: string title: String title: type: string title: String required: - code - message - severity - title title: AdvisorRecommendationResponse com.apollodeploy.commons.core.error.FieldProblem: type: object properties: detail: type: string title: String pointer: type: string title: String required: - detail - pointer title: FieldProblem com.apollodeploy.signal.feature.deliverability.api.model.AdvisorRecommendationDataResponse: type: object properties: accepted: type: integer format: int32 title: Int accepted24h: type: integer format: int32 title: Int adjustedOpenRate: type: number format: double title: Double avgDailyAccepted7d: type: integer format: int32 title: Int bounceRate: type: number format: double title: Double bounced: type: integer format: int32 title: Int complaintRate: type: number format: double title: Double daysSinceLastSend: type: integer format: int32 title: Int delivered: type: integer format: int32 title: Int dmarcAccountedRate: type: number format: double title: Double dmarcAlignedMessages: type: integer format: int64 title: Long dmarcAlignmentFailureRate7d: type: number format: double title: Double dmarcCurrentPolicy: type: string title: String dmarcDomain: type: string title: String dmarcObservedMessages: type: integer format: int64 title: Long dmarcRecommendedPolicy: type: string title: String dmarcReportingDays: type: integer format: int32 title: Int dmarcUnknownMessages: type: integer format: int64 title: Long dmarcUnknownSources: type: integer format: int32 title: Int humanOpenRate: type: number format: double title: Double proxyOpens: type: integer format: int32 title: Int proxyRate: type: number format: double title: Double reportedOpenRate: type: number format: double title: Double totalOpens: type: integer format: int32 title: Int unsubRate: type: number format: double title: Double unsubscribed: type: integer format: int32 title: Int title: AdvisorRecommendationDataResponse securitySchemes: bearerAuth: type: http scheme: bearer description: >- Project-bound Apollo Signal API key. Keys begin with `ap_signal_` and must carry the permission shown on the operation. ````